
one regional card for all 


Central Puget Sound 
Regional Fare Coordination System 


ORCA Institutional Program Website 
Functional Specification 


Document No: SEA-01654 Category: Phase 2 Revision: 27.0 

Publisher: Vix Technology Revision Date: Apr 29, 2013 


Author 


Process Manager 


Manager 


Name: 

Signature: 

Date: 


Paraic Reddington 


Joseph Lee 


Doug Thomas 


» VIX'' 


This material is delivered to the Contract Administrator under Contract No. 229944, a Contract for the Development, Operation and 
Maintenance of the Central Puget Sound Regional Fare Coordination System. The material is copyright protected and, except as 
provided in that Contract, may not be reproduced, stored in a retrieval system or transmitted in any form or by any means in whole 

Confidential 











Document History 

Reason for Issue 

Author 

1st Draft - for comment 

Leon Cosgrove 

Release to Customer 

Patrick Branch 

Modifications made after comments from customer 

Leon Cosgrove 

Modifications made after internal DR2 review 

Leon Cosgrove 

Modifications made after internal review 

Leon Cosgrove 

Updates made for DR1 B submission 

Paraic Reddington 

Updated following internal reviews 

Paraic Reddington 

Further updates following internal reviews 

Paraic Reddington 

Edit for resubmission 

Stephen Lynch 

Release to Customer 

Patrick Branch 

Updated to include FDR customer comments 

Paraic Reddington 

Edit for resubmission 

Deborah McDaniel 

Release to Customer 

Patrick Branch 

Updated to include changes as a result of web design 

Paraic Reddington 

Updated following review meeting held on 7/19/05. 

Paraic Reddington 

Edit for release to Customer 

Deborah McDaniel 

Release to Customer 

Patrick Branch 

Updated following review with Agencies. 

Paraic Reddington 

Updated to cover comment F0-AG-99901 

Paraic Reddington 

Edit for resubmission 

Stephen Lynch 

Release to Customer 

Patrick Branch 

Minor changes for test planning 

Paraic Reddington 

Changes following release of Institutional website 
wireframes 

Paraic Reddington 

Ongoing changes from review meetings with customer 
and RFI responses. Added Lead Agency derivation 
matrix as Appendix A. 

Paraic Reddington 

Updates required for clarification/greater detail during 
development 

Paraic Reddington 

Delete FDR comment bubbles from 5.0 submission and 
format for resubmission 

Stephen Lynch 

Release to Customer for review 

Rose Fallaw 

Updates for Phase 2 Release 1 RFCS RFI 317 

Paraic Reddington 

Updates for Phase 2 Release 1 RFCS RFI 364 

Pauline Downey 

Edit for submission 

Tricia Spicer Bekey 


















Central Puget Sound 

Regional Fare Coordination System 


Security Li 














Central Puget Sound 

Regional Fare Coordination System 


Security Level 3 


ORCA Institutional Program 
Website Functional Specification 


Contents 


1 Introduction.11 

1.1 Purpose.11 

1.2 Scope.H|.11 

1.3 Training Mode.13 

1.4 Data Entry.14 

1.5 Constraints.14 

1.6 Terminology.15 

1.6.1 Acronyms and Abbreviations . 15 

1.6.2 Terms . 15 

1.7 References.16 

2 Business Accounts Website Functionality.18 

2.1 Card Serial Number Search.18 

2.2 Business Accounts Welcome.18 

2.3 Register for Website Access.19 

2.4 Business Account Representative User Login.20 

2.5 Apply for New Agreement.22 

2.6 Maintain Business Account Agreement.30 

2.7 Busiress Account Orderirg.38 

2.7.1 Payment Method - Credit Card . 41 

2.7.2 Product Order Export . 46 

2.7.3 Product Order Import . 47 

2.8 Order Cards.48 

2.9 Order Vouchers.51 

2.10 Order E-purse Value.52 

2.11 Order Pass Products.54 

2.12 Order Multi-ride Products.55 

2.13 Order Business Passport P-oducts.57 

2.14 Order Commercial Account Products.58 

2.15 Business Account Order Summary Confirmation.58 

2.16 Card Account Summary.61 

2.17 Card Account Page.62 

2.18 Card Disassociation.70 

2.19 Caro Replacement.75 

2.20 Purse Refund Request.81 

2.21 Create/Maintain Branches.83 

2.22 Maintain Business Account Card Groups.85 

2.23 Block Card Group.91 

2.24 Unblock Card Group.92 

2.25 Change Passwo-d.92 

2.26 Generate Reports.93 

2.27 Logout.93 

2.28 Update Autoload Type.94 

2.29 Maintain Vanpool Subsidy Table.95 

2.30 Contact Us.96 

3 ESB Business Account Functions.98 

3.1 Maintain Business Account Program Rules.98 

4 Lead Agency Accessible Agency Functions.99 

4.1 Lead Agency User Login.99 


Vix Confidential © Vix 2013 
To be disclosed only to Agency personnel who 
have a need to know 


SEA-01654 

Revision 27.0/Apr 29, 2013 


Page 









Central Puget Sound 

Regional Fare Coordination System 


Security Level: 


ORCA Institutional Program 
Website Functional Specification 


4.2 Business Account Agreement Administration.102 

4.3 Access Knowledge Base.110 

4.4 Upload Card Printing Template.110 

4.5 Business Account Agreement Application Approval.111 

4.6 Lead Agency Order Approval.113 

4.7 Maintain Business Passport Programs.114 

4.8 Maintain Electronic Voucher Programs.120 

4.9 Maintain Business Choice Program.121 

4.10 Maintain Business Account Agreement Rules.123 

4.11 Extend/Renew/Suspend/Terminate Business Account Agreement.123 

4.12 Manage Business Account Whitelist.129 

4.13 Create Business Account Agreement.130 

Appendix A Agency Location Matrix.135 

Appendix B Transaction History Source Data.143 

Appendix C File Formats.146 

C.1 Product Order Import/Export File Formats.146 

C.1.1 CSV File and Record Structure . 146 

C.1.2 XML Product Order File and Record Structure . 150 

C.2 Card Personalization File Format - XML File and Record Structure.153 

C.3 Create/Maintain Card Groups • XML File and Record Structure.155 

Appendix D Traceability Matrix.157 


List of Tables 


Table 1: Acronyms and Abbreviations.15 

Table 2: Terms.15 

Tabe 3: New Agreemert Applicaton Details.26 

Table 4: Maintain Agreemert Details.30 

Table 5: Payment Receipt Details.45 

Table 6: Card Order Details.48 

Table 7: Voucher Order Details.51 

Table 8: E-purse Value Order Details.53 

Tabe 9: Pass Product Order De:a Is.54 

Table 10: Multi-ride Product Order Details.56 

Tabe 11: Business Passpo-. Order De:aIs.57 

Table 12: Commercial Account Order De:a Is.58 

Table 13: Confirming a Business Account Order.60 

Table 14: Card Account Summary Details.62 

Tabe 15: Card Accourt Page Details.62 

Table 16: Cardholder Group Details.86 

Table 17: Business Account Vanpool Fare Coverage Information.95 

Table 18: Available Functions Based on Agreement Status.101 

Table 19: Business Account Agreement Administration Functions.102 

Table 20: Business Account Agreement Administration Details.103 

Table 21: Lead Agency Order Approval Details.113 

Table 22: Business Passport Product Details.114 

Table 23: Business Choice Program Product Details.121 

Tabe 24: Agreement Extension Detai s.125 

Tabe 25: Agreement Renewal Details.125 

Table 26: Agreement Suspension Details.126 

Table 27: Agreement Termination Details.127 

Table 28: Available Status Changes for Agreements.128 


SEA-01654 Vix Confidential © Vix 2013 Page 8 of 


Revision 27.0/Apr 29, 2013 To be disclosed only to Agency personnel who 

have a need to know 









Central Puget Sound 

Regional Fare Coordination System 


Security Level: 


ORCA Institutional Program 
Website Functional Specification 


Table 29: Business Account Whitelist Details.129 

Table 30: New Agreement Application Details.131 

Table 31: Lead Agency Derivation Worksheet.135 

Tabe 32: Transaclion History Source Data.144 

Table 33: Product Order CSV File Elements.146 

Table 34: Format and Rule for the CSV File Elements.147 

Table 35: Complex Elements Description.148 

Table 36: Non-Contract Traceability Matrix.157 


List of Figures 

Figure 1: Website Functionality for Business Account Representative. 

Figure 2: Website Functionality for Lead Agency Representative. 

Figure 3: Training Mode Example. 

Figure 4: Business Accounts Welcome Page - Left Navigation Bar. 

Figure 5: Blocked Account - Password Reset. 

Figure 6: New Customer Sign Up Question. 

Figure 7: New Customer Sign Up - 1. 

Figure 8: New Customer Sign Up - 2. 

Figure 9: Register New Agreement - Enter Contact Details. 

Figure 10: Register New Agreement - Select Password. 

Figure 11: Register New Agreement - Review Details 1 . 

Figure 12: Register New Agreement - Review Details 2. 

Figure 13: New Agreement Header Tabs. 

Figure 14: New Agreement Buttors. 

Figure 15: Maintain Business Account Agreement - 1. 

Figure 16: Maintain Business Account Agreement - 2. 

Figure 17: Maintain Business Account Agreement - 3. 

Figure 18: Maintain Business Account Agreement - 4. 

Figure 19: Maintain Business Account Agreement - 5. 

Figure 20: Maintain Business Account Agreement - 6. 

Figure 21: Maintain Business Account Agreement - 7. 

Figure 22: Current Order Summary. 

Figure 23: Shopping Cart - Standard (Post-Pay). 

Figure 24: Order Status Flow - Standard (Post-Pay). 

Figure 25: Shopping Cart - Credit Card Payment Method Set (Pre-Pay). 

Figure 26: Order Status Flow - Credit Card Payment Method Set (Pre-Pay). 

Figure 27: Credit Card Payment - Complete Order Page. 

Figure 28: Credit Card Payment -Confirmation Page. 

Figure 29: Order Summary - Exoort. 

Figure 30: File Download Dialogue. 

Figure 31: Create Product Order - Import. 

Figure 32: Youth Card Expiration. 

Figure 33: Card and Product Order - Validity Period Display. 

Figure 34: Shoopirg cart page. 

Figure 35: Card Account Summary Page - Search. 

Figure 36: Card Account Summary Page - List. 

Figure 37: Card Account Page - Detail. 

Figure 38: Block Card - Confirmation. 

Figure 39: Block/Unblock Procucts. 

Figure 40: Transaction History Page. 

Figure 41: Transaction History Detail. 

Figure 42 Cards page. 

Figure 43 Card account page. 

Figure 44 Disassociate cards page. 

SEA-01654 Vix Confidential © Vix 2013 

Revision 27.0/Apr 29, 2013 To be disclosed only to Agency personnel who 

have a need to know 


12 

12 

13 

19 

21 

22 

23 

23 

24 

24 

25 
25 

25 

26 

34 

35 

35 

36 

36 

37 

38 

39 

40 

41 

42 


45 

47 

47 

48 

55 


63 

64 
64 
68 

69 

70 

71 

72 


Page! 















Figure 45 Disassociate confirmation page. 

Figure 46 Success/failure messages. 

Figure 47 Deferred disassociation. 

Figure 48 - BA user view. 

Figure 49 - Lead Agency user view. 

Figure 50 - Replace card screen. 

Figure 51 - Replacement with new card stock. 

Figure 52 - Replacement with existing card stock. 

Figure 53 - Receipt page • no fee. 

Figure 54 - Rece p: page • fee. 

Figure 55: Create Branch. 

Figure 56: New Card Order - Branch Name. 

Figure 57: Maintain Card Groups. 

Figure 58: Remove Card Group - Confirmation. 

Figure 59: Move Cards. 

Figure 60: Import a Group. 

Figure 61: Import a Group - File Exception Details. 

Figure 62: Rename a Group. 

Figure 63: Ado a card. 

Figure 64: Crystal Reports Login Page. 

Figure 65: Update autoload type. 

Figure 66: Contact us - public. 

Figure 67: Contact us - private. 

Figure 68: Search For An Agreement Page. 

Figure 69: Search For An Agreement Results Page. 

Figure 70: New Agreement Header Tabs. 

Figure 71: New Agreement Buttons. 

Figure 72: Payment Method/Terms Page. 

Figure 73: Pending agreement summary page. 

Figure 74: Restore Declined Agreement. 

Figure 75: Business Passport Setup - Main. 

Figure 76: Business Passport Setup - Flat Rate with Ridership. 

Figure 77: Business Passport Setup - Flat Rate with no Ridership. 

Figure 78: Business Passport Setup - Per-Trip With Ridership. 

Figure 79: Business Passport Setup - Per-Trip with no Ridership.. 

Figure 80: Electronic Voucher Product Filter. 

Figure 81: Business Choice Program Product Filter. 

Figure 82: Order Rules. 

Figure 83: Terminate Agreement Confirmation. 

Figure 84: Agreement Status Flow. 

Figure 85: Business Account Whitelist. 

Figure 86: Example Product Order - CSV Format. 


.73 

.73 

.73 

.75 

.76 

.77 

.78 

.78 

.79 

.79 

83 



119 

120 
122 
123 
128 
128 
130 
149 






Central Puget Sound 

Regional Fare Coordination System 


Security Level: 


ORCA Institutional Program 
Website Functional Specification 


1 Introduction 

The Business Accounts website provides functionality for Business Account and Lead 
Agency representatives to carry out various Business Account Program functions in the 
Regional Fare Coordination System (RFCS). Access to functions will be limited to users 
with appropriate access privileges. 


1.1 Purpose 

The purpose of this document is to gain the agreement from the RFCS Regional Team 
and the RFCS Agencies of the web functionality to be provided to Business Account 
Programs. It will also be used as input to the web pages development activity. 

This document forms one of the four specifications that provide the main input to SEA- 
01342 Customer Service Website and CRM Design (DR IB) [2] in the Group 3 Final 
Design Review (FDR) delivery. 

The other three documents that provide main inputs to DR 1B are: 

• SEA-01438 ORCA Cardholder Website Functional Specification [3] 

• SEA-01535 ORCA Agency Website Functional Specification [4] 

• SEA-01539 ORCA Call Center Website Functional Specification [5] 


1.2 Scope 

This specification deals only with the secure area for portions of the Business Accounts 
website, as specified in the Contract [1] and the feedback provided in the workshop and 
RFI processes. 

Figure 1 shows the Business Accounts website functionality described in this 
specification from the perspective of the Business Account representative, and Figure 2 
shows the Business Accounts website functionality described in this specification from 
the perspective of the Lead Agency representative. 
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1.3 Training Mode 

The Business Account website can be operated in training mode. This allows a user to 
perform limited Business Account activities for training purposes in a controlled 
environment 

Only a user with the appropriate privileges can place the website into training mode. The 
user's account must have the Training Role configured, as well as sufficient authority to 
perform the standard functions available in this mode. 

When in training mode, the website will clearly display "TRAINING MODE” (see Figure 
3). If the user has the Trainer role then the website will display "TRAINER MODE”. If the 
website is being used in training mode, the production version of the website will remain 
available to all other users. 





Figure 3: Training Mode Example 

When a user with the Training Role logs on to the Business Accounts website, the user 
will only be able to view, create and modify Training Business Accounts and Agreements. 
The Training Agreement will follow all standard rules and will be treated as a normal 
Business Account. However, there will be no funds movement associated with actions on 
the Business Accounts website in training mode. 

The Business Accounts Training user will be able to: 

• Order Training Cards (TRAINING users will only see training orders and TRAINER 
users will only see trainer orders) 

• Order Products 

• Create and Maintain Training Card Groups 

• Create and Maintain Programs 

• Search for Training Agreements 
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• Create Training Agreements (Agreements can only be created by a Lead Agency 
user - not ‘applied for’ as a public business user as there is no training login in this 

• Approve Training Business Account’s Card and Product Orders 

• Upload a Card-printing Template 

• Modify Program rules 

• Modify Order rules 

The following actions will allow the training user to view and modify these items, but upon 
submittal of the action, the system will ignore the change and not update the Back Office 
system No Work Orders or Actionlists will be generated for training product or card orders 
(the exception is card orders created by a user with the Trainer role). These will be 
displayed on the website until the user logs off when they will be discarded: 

• Management of the Business Account Whitelist (training agreements are not placed 
on the production Whitelist) 

• Card orders (this does not apply to orders for Training Cards, see below). 

• Product orders 

Orders for training cards will only be fulfilled when created by a user with the Trainer role. 
These orders must be approved by a user with the trainer role and will be fulfilled by the 
ESB. All cards ordered and UD generated as a result of the user operating the Business 
accounts website with the Trainer Role will have the training bit set. 

1.4 Data Entry 

Certain fields on the Business Accounts website have maximum allowable lengths. 
Wherever data needs to be entered into such fields, the user will not be able to enter 
more than the maximum number of characters. 


1.5 Constraints 

Text and customer information required for nonfunctional pages may need to be provided 
by the RFCS Regional Team and Agencies. The required information may include: 

• Frequently Asked Questions (FAQs) 

• Program information 

• Business Account information 

• Using ORCA information 

• Error messages, wording, and so forth throughout the website 

• The design of printable forms that can be downloaded from the website 

• Any additional text and customer information 

The completion of this RFCS-provided information, and requests for changes to it, should 
not affect the acceptance and signoff of the documents that make up the DR 1B CDRL 3 
submission for FDR. These documents are listed in section 1.7. 
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1.6 Terminology 

This section contains a list of acronyms, abbreviations, and terms used in this document. 

1.6.1 Acronyms and Abbreviations 


Table 1 contains the acronyms and abbreviations that are specific to ERG. Industry 
standard acronyms and abbreviations are not defined in this table. 

Table 1: Acronyms and Abbreviations 



Table 2 contains the terms that are specific to Vix. Industry standard terms are not 
defined in this table. 

Table 2: Terms 
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Definition 


Account 

Cardholder 


Account Card 
ID 


Choice 


Card Printing 
Template 


Clearinghouse 


A group of individual cards that the Business Account manages with 
the same strategy. 


A unique system generated identifier used to distinguish between 
individual transit cards. 


Business Account program in which a specified pass or stored value 
amount is loaded to a card or a series of cards through remote 


Files in ID Works™ format that contain images for card printing. 
These templates are used for Business Account card orders that 
share a unique common graphic or require special card 
personalization (secondary printing). 

The central revenue control and settlement system. 


B Vix_Service Bureau 

id Agency An Agency that oversees or 


re Business Accounts. 


Lead Agency The Lead Agency generates this number to identify Business 
Business Accounts for which it has an agreement. 

Account ID 


participant 


Participating 
Agency 
product issuer 


Unblocking 


A business organization providing a number of functional roles within 
the system, bound to other RFCS participants by signing an 
agreement with the Clearinghouse. For example, an Agency 
providing a fare payment service is a participant. 

An Agency that issues products used by Business Account 
cardholders. 


Any Participant who owns a transit product - including the purse - 
that may be loaded on a RFCS card. 

All Agencies, the Float Account Manager, and the Regional Pass 
Manager are considered product issuers because they own products 
that may be used within the RFCS program for fare payment. 
Resetting the state on the card to allow the card, application, and/or 
product to become available for use after it has been blocked. 
Unblocking can occur at customer service devices by actionlist 
requests, or, if appropriate, by device business rules. 


1.7 References 

The following materials are to be used in conjunction with this document. 

[1 ] Contract 229944 (April 29, 2003) 

[2] SEA-01342 

Customer Service Website and CRM Design (DR 1B) 

[3] SEA-01438 

ORCA Cardholder Website Functional Specification 
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[4] SEA-01535 

ORCA Agency Website Functional Specification 

[5] SEA-01539 

ORCA Call Center Website Functional Specification 

[6] SEA-00833 

RFCS Reporting Requirements (DR 111) 
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2 Business Accounts Website Functionality 


2.1 Card Serial Number Search 


Description The Business Accounts website allows Lead Agency or Business Account users to search for 
individual cards. 

Security Lead Agency or individual Business Account (a Business Account can search on its own cards) 

Requirements Individual Business Accounts may have large numbers of cards (>60,000). For any function 

where an individual card serial number is required, a card serial number search facility should be 
provided. The user is prompted to enter any of the following details: 

• Groups 

• Card serial number 

• Card status 

• Product (drop-down list by name) 

The user is prompted to select the Search option when the data has been entered. 

If any of the details are not valid or a match is not found, an appropriate error message is 
displayed, and the user is asked to try again. 

If more than one card match is found, a list is displayed and the user is prompted to select an 
individual card. The list details are the same as the details that the user was prompted to enter 
when initiating the search. 

• Once an individual card is selected, the user is taken to the Card Account Details page for 
that card. 


2.2 Business Accounts Welcome 

Description The Business Accounts website provides a welcome to the Business Account representatives to 
either apply for a new agreement or register for website access. This is located in the public area 
of the Business Accounts website and is labeled ORCA Business Account Home. 

Security Business Account 

Requirements The user will be presented with the following navigation options: 
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Figure 4: Business Accounts Welcome Page - Left Navigation Bar 
If the user has an agreement that was created by the Lead Agency, then the Business 
Account user will be able to register for website access (refer to section 2.3). 

If the user already has website access, then the user selects the Business Account Log In 
link (refer to section 2.4). 

If the user has never applied for an agreement, the Business Account representative will 
select the Sign Up Now option (refer to section 2.5). (Note that the usual online agreement 
rules apply.) 

A "Skip to Main Content" link will be on the header of every page. 


2.3 Register for Website Access 


Description The Business Accounts website allows Business Account representatives to register for website 
access. This is necessary for manual agreements only. 

Security Public 

Requirements The user has selected the ‘Obtain a log in for your existing business account’ option. 

The user will be prompted to enter his or her Business Account ID. The screen prompt reads: 
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“This will serve as your Business Accounts Website Username. You will need it to login to the 
Business Accounts website in the future. Please retain this ID.” 

If the Business Account ID entered matches an agreement that has a status of Pending or 
Terminated, the user will be prompted “Sorry no active agreement was found matching the 
Business ID you entered. Please check the ID and if you continue to have problems, contact 
your Lead Agency.” and no access is granted. 

If the entry is valid, the user will be asked to enter and confirm a Password before the 
registration can be approved. 

The system will check for any existing agreements matching the details entered. If the 
agreement already has online access then an error message will be displayed as follows: “This 
agreement has already been registered for website access. You can login using the Business 
Account Log In.” If the agreement does not already have online access the message “You have 
signed up successfully. You can now login to the website.” will be displayed and the user can 
login as usual. 


2.4 Business Account Representative User Login 

Description The Business Accounts website allows login by an authorized Business Account representative 
who has previously been set up with the appropriate system access rights with username and 
password. 

Security * Business Account (access to own online and manual agreement information with access to 

functionality restricted) 

• Lead Agency (Full Access) 

• All Agencies (Read only access) 

Requirements The user will be asked to enter his or her Business Accounts website username (Business 

Account ID) and password (6-15 alphanumeric characters). The password can cover Business 
Accounts with online and manual agreements. They are mutually exclusive. 

If the entries match an agreement that has a status of Pending or Terminated, the user will be 
prompted “The Agreement selected is not currently active. Please contact the Lead Agency for 
further information.” and no access is granted. 

If the entries do not correspond or are invalid, then an error message will be displayed and the 
user will be asked to retry. 

After three successive incorrect login attempts the account will be blocked and must be reset. A 
message will be displayed stating that the account has been blocked and must be reset. The 
user will be directed to the reset password page. 
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Figure 5: Blocked Account - Password Reset 

• The user can also directly access this page by clicking Forgotten Login Details on the login 
page. 

• The user is required to enter the Business Account ID and either the Business Name or Tax 
ID. 

The system generates an automated email containing username and a new password to be 
emailed to the primary Business Account contact. 

If the login is successful, the Lead Agency Business Account ID is displayed and the user is 
presented with a list of functions that can be performed according to the user’s access rights: 

If the Business Account representative successfully logs on, then the following options are 
displayed: 

• Maintain Business Account Agreement 

• Card Account Summary 

• Business Account Orders 

. Business Account Order Summary Approval 

• Assign Cards to Business Account Groups 

• Update Autoload Type 

• Change Password 

• Access FAQs 

• Generate Reports 

The Logout option is always provided. The Business Account ID and Lead Agency ID are always 
displayed on screen when the user is logged in. 
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2.5 Apply for New Agreement 


Description The Business Account website allows application for a new agreement. 
Security Business Account 


Requirements A prerequisite is that the Business Account representative has chosen to create an online 


agreement. 

• The Business Account representative is asked which products they would like to order: 


New Customer Sign Up 


To get started, please choose the appropriate program below. Next, we'll ask you to supply the 
information we need to begin the process. 

Ybur account will be assigned a Lead Agency based on the location of your business and you'll 
be contacted within seven business days to finalize your application. 

Want more information? Refer to our Proorams pane to determine the best program for your 
business needs or contact us for more information. 

O Business Choice program (e-purse, e-voucher and monthly passes ordered online). 

O Business Passport program (annual passes for all employee/students ordered from Lead 
Agency). 

O l don't yet know which program I want. 

Please provide information on which program you are interested in:* 



*500 characters max 


Figure 6: New Customer Sign Up Question 


The user can choose just one of the three options. The user cannot choose both program types. 
If the user chooses any option and clicks on the contact us link then the option selected or text 
entered will not be stored. 

If the user clicks on Apply Online then the option selected and text entered will be stored and the 
online application will continue. Therefore a user can select 'I don’t know’ and still apply online. 

In this case the Lead Agent would subsequently contact the user to determine the best program 
type. 

The system will store the selection made and any text entered only if the Apply Online button is 
selected. 

The programs link will direct to the existing programs comparison page. 

By clicking the contact us link on the New Customer Sign Up page the user will be directed to 
the Contact Us page. 

Once the user selects Apply Online they will be directed through the application process. 


SEA-01654 


Vix Confidential ©Vix 2013 
To be disclosed only to Agency personnel who 


Page 22 of 160 


Revision 27.0/Apr 29, 2013 


i need to know 





Central Puget Sound 

Regional Fare Coordination System 


Security Level: 


ORCA Institutional Program 
Website Functional Specification 


/orca 


New Customer Sian Up 




Figure 7: New Customer Sign Up -1 



Figure 8: New Customer Sign Up - 2 
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Figure 9: Register New Agreement - Enter Contact Details 



Figure 10: Register New Agreement - Select Password 
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Figure 11: Register New Agreement - Review Details 1 





Figure 12: Register New Agreement - Review Details 2 
Agreement details are entered via a series of pages. There will be a number of header 
tabs across the top of each page to show the user where they are in the process and 
their progress. These tabs are links so that the user can go back and change any 
details as required. Data that has already been entered will not be lost if the user 
moves to a different page. 


New Customer Sign Up 



| 1. Business II 2. Contact info II 

| account info | 

3. Website 

4. Check J 





Figure 13: New Agreement Header Tabs 

o There will also be Back and Next buttons to allow the user to move between pages if 
required. Clicking Next will automatically save any information entered on the current 
page. Clicking the Cancel button will abort the application without saving any data. 
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Figure 14: New Agreement Buttons 
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Coordination System 


Security Level 3 


Website 


• The user selects the function to save the details. 

• The system prompts the user to confirm that agreement applicatic 
Once all details have been validated the Business Account ID is displt 
prompted: “Your unique Business Account Identification Number is [Bi 
will need this number and the password you selected to gain online ac 
Please retain it securely." 

The agreement will be assigned a Pending status and must be approv 
The user will be returned to the Business Accounts Welcome page. 


Maintain Business Account Agreement 

The Business Account website allows the Lead Agency/ Business Acc 
existing agreement. 

Lead Agency (Manual and Online agreements) 

Business Account (Agreements with online access) 

The user is presented with the following information: 


Table 4: Maintain Agreement Details 
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Figure 15: Maintain Business Account Agreement -1 
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* | Washington J 
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Figure 16: Maintain Business Account Agreement - 2 



Figure 17: Maintain Business Account Agreement - 3 
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Figure 18: Maintain Business Account Agreement - 4 


l Agreement Summary 


' Vanpool Subsidies 1 


► Voucher Rules 

► Order Rules 


► Current Order 
Summary O 

► Approve Orders 


Accounts W 
> Create: Maintain 


Business Account Agreement Administration 

SIBusinessChoice Lead Agency: King County Metro 

Business account Contact j Program Payment methods Approvals and 

| ' information. || Information || Information || ../terms". || ..dates. 


Enter or update the program information for this agreement. Click “Save" to save any changes. 
Fields marked with an asterisk (*) are required 
Program Category: * | Employer Ml 

Number of [jq 


Lead Agency: * | King County Metro 


0 CommunityTransit 

□ Everett Transit 
0 King County Metro 

□ Kitsap Transit 

□ Pierce Transit 

□ Sound Transit 

0 Washington State Ferries 
Card Registration Not Permitted: 0 

Other Transportation Benefits Offered: 

Benefit A: 


Figure 19: Maintain Business Account Agreement - 5 
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Figure 20: Maintain Business Account Agreement - 6 
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Figure 21: Maintain Business Account Agreement - 7 

o The user selects the function to save the details. 

o The system prompts the user to confirm that all agreement application details are 
correct. 


2.7 Business Account Ordering 


Description The Business Account website allows the authorized user to access the website to order cards or 
order products to assign to the Business Account cards. 

Security Lead Agency 

Business Account 

Requirements Business Account orders are created by the user through the Current Order Summary page. The 
Current Order Summary page will display all orders except orders with a status of Pending, 
Validating, and Ready for payment (i.e., orders with a status of Confirmed, Approved, Completed 
or Canceled). 
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Business Account Agreement Administration 


ACME 

Shopping Cart 


Lead Agency: Kitsap Transit 


st of your pending orders Select any orders you wish to confirm or 


fe'O 



□ 2122 Pending 03123/2007 

□ 2122 Validating 03/23/2007 

□ 2121 Pending 03(23/2007 

□ 2127 Pending-with 03/23/2007 




S 20.00 


Once orders are confirmed, they must be validated before they are ready for approval. 

Validation may take up to 2 hours Please feel free to logout and return to your Shopping Cart at a 


Figure 23: Shopping Cart - Standard (Post-Pay) 

. Pending orders in the Shopping Cart can be removed (Cancelled) or Confirmed at any time. 

• Clicking 'Remove from Shopping Cart’ will display a confirmation message. Clicking 
‘Confirm’ will not. Cancelled orders cannot be updated subsequently. 

• Confirmed orders can be Unconfirmed on the Current Order Summary page. 

• A Pending order can be updated by clicking the Order Number link. Pending orders can be 
updated any number of times before being confirmed. 

• Cards and products can be added or removed from an order as required. These updates 
will be automatically reflected in the Shopping Cart. 

• There is no limit to the number of pending orders or the number of cards in any single order. 

• New orders can be created before other orders are confirmed. 

• Product orders can be for multiple card groups or individual cards. 

• Each product order will not be restricted to a single group. 

• Card orders can only be for a single card group. 

All Pending orders must be confirmed before they can be approved by the Lead Agency. Note 
that the Lead Agency representative will need to confirm that payment has been received. When 
payment is received, the Lead Agency will approve the order, via the Lead Agency Approval 
function. Once an order is confirmed it will be set to a status of Validating and remains in the 
shopping cart. It cannot be updated at this stage. 

If a Confirmed order fails system validation (e.g., an existing product on a card has been 
ordered), then the order will be set back to Pending - with errors. It must be updated and re¬ 
confirmed by the user. 

Any product orders (or card orders including products) that include a purse component (either 
directly or as a residual for a voucher) will be validated to ensure that no cards with an 
inaccessible purse have been included. If so, the order will fail and be set to Pending. 

If the order passes validation, it is set to a status of Confirmed and is not displayed on the 
Shopping Cart. It is now visible on the Current order summary page. 
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Figure 24: Order Status Flow - Standard (Post-Pay) 

2.7.1 Payment Method - Credit Card 

Where the agreement has a payment method of ‘Credit Card’ and payment terms of ‘Pre- 
Payment’, the Business Account (or Lead Agency) user is able to pay for confirmed orders 
online. In this case, the Shopping Cart page will also have a ‘Process payment' button. 
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Business Account Agreement Administration 

ACME Lead Agency: Kitsap Transit 



Once orders are confirmed, they must be validated before they are ready for payment. You can only 


Figure 25: Shopping Cart - Credit Card Payment Method Set (Pre-Pay) 

The user can select Pending orders and confirm them. Confirmation sends the orders for system 
validation. The order will show a status of “Validating.” 

Once the orders have been validated, they will be displayed in the shopping cart with a status of 
'Ready for payment.’ 

The user can then select these orders for payment. Multiple orders can be selected for payment 
at the same time. 

Orders can be cancelled when in a state of Ready for Payment. 

Pending orders or orders that have not yet been validated cannot be selected for payment. 

Once an order has been paid, it is set to a status of Approved and cannot be amended or 
cancelled. 
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Figure 26: Order Status Flow - Credit Card Payment Method Set (Pre-Pay) 

The 'Process Payment’ button and ‘Ready For Payment’ status are only displayed for users with 
a Payment Method of Credit Card (as set up by the Lead Agency in the agreement details - 
Payment Methods/Terms tab) and payment terms of ‘Pre-Payment.’ 

The left navigation bar does not change at any time (Shopping Cart is always displayed). 

Once the user selects the Process Payment button, the user is directed to the Complete Order 
page to enter credit card details. 

These details are for a single use only and are not stored in the system. 

If the card details are valid and the payment is accepted, the order is set to Approved. 
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Once the user clicks on Make Payment, the card details are validated. If invalid, an 
error message is displayed and the payment is not completed. If the details are valid, 
the payment is processed and a confirmation page is displayed, including receipt 
details for the payment. A Print receipt button is available. The following payment 
details will be added to the order notes (for card orders) and order audit log (for 
product orders) for reference: 
o Date/Time 
o "Credit card payment" 

o Credit card number (last 4 digits in the format ******1234) 
o Card type 

o Authorization number in the format “Auth #: 99999” 
o Amount 
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Complete Order 



Figure 28: Credit Card Payment -Confirmation Page 
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Clicking the Export button will open a standard file download dialogue box. 



Figure 30: File Download Dialogue 


2.7.3 Product Order Import 

Product orders can be imported to the Business Accounts website from previously created XML 
or CSV files. File formats are detailed in Appendix C. When the user selects to create a new 
product order they are given an option to import the order from a file. 
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Figure 31: Create Product Order - Import 


Once the user browses to a file and clicks on Import the system will validate the file to ensure 
that the file is valid. 


2.8 Order Cards 


Description The Business Account website allows authorized users to order cards for a Business Account 
that has a Business Account agreement. The Business Account card order function on the 
system communicates the order details to the Card Inventory system. The Card Inventory 
system records the order detail. The order number and order date are generated by the Card 
Inventory system and returned to the database. (The submitted order can be modified only by 
the Lead Agency representative.) 

Security Lead Agency 

Business Account 

Requirements The user is presented with a list of the card order fields to be completed for the selected 

Business Account, as shown in Table 6. It is a prerequisite that the relevant Business Account 
has been identified. 


Table 6: Card Order Details 
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Data Element 


Personalization File 


Field Constraints (O - 
optional, R - required, S 
- system generated) 


Youth Card Expiration 


The description of the 
selected template. 

Optional field where the user 
can browse to an XML 
personalization file to match 
the selected template. The 
file name will be displayed. 


Required if the passenger 
type is Youth (hidden 
otherwise). The MM/YYYY 
field populates the 
passenger type expiration 
date. “Required for Youth 
card orders only” is 
displayed. 




Create New Card Order 


1. Order Details » 2. Select Products 

Please provide the order details 

below: 

Fields marked with an asterisk 1 

(*) are required 

Date Created: 

01/10/2008 

Branch Name: 

Head office v 


Default Group -1049959 v | 

Quantity: 


Card Type: 

Standard v Q 

Card Printing Template: 1 

Choose v,| 

Si 

§ 7 


Passe.,, Type 

iYgiPai 


□ QW--** -° rdere on* 



Notes Log: 

1 
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- system generated) 


O 


This is an optional free 
format field. This field cai 
used for any special 
instructions to the fulfillin 

party. _ 

The $ fee to be charged 
each card in the order. T 
will be a default fee per 
agreement. Online 
agreements will have a 
standard fee. 


O 


O 

O 


O 

O 


Lead Agency only. Checl 
box that defaults to 
unchecked. 


Check box for each prog 
The effective date for pei 
products 

$ amount free format fief 


Business Passport prodt 
are available for online o 
manual agreements and 
available for disposable 


R 

Drop-down list i 


All retail products will be 
available for selection as 
dictated by the Business 
Choice Program. 

This field will be populate 


f 2 entries 


with the full month name: 
and year of the next 2 va 
months for the product 


System generated 


The retail value of the 
product. The Business 
Passport products will he 


zero. Commercial produc 
can only be available to 
WSF Lead Agency Busir 
Accounts. 


R Drop down of the valid 

revalue types for the 
agreement 

S The value of the voucher 


S The residual amount Of 1 

voucher that will be appli 
to the purse 


Business Account will have to fill in the general agreemei 


iential © Vix 2013 Page 50 ol 

ly to Agency personnel who 
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details and specify if they will be using a credit card. 

If an agreement is a manual agreement, card orders will be restricted to Adult and Youth cards. 
The Business Accounts will be able to order the cards, but the disposable cards will not have a 
Youth Card Expiration on the cards. The Business Passport products will be those already 
assigned to the agreement. 

The card type KC Employee ORCA ID is available only to Agency users and the King County 
Business Account (with Community Transit as Lead Agency). Orders for this card type should be 
placed by the King County Business Account or the Community Transit Lead Agency. Orders will 
be fulfilled by the KCM Mail Center. A card printing template or personalization file cannot be 
specified for this card type. Any attempt will generate an error. 

The user is prompted “Do the cards ordered require additional printing/personalization?” If yes, 
then additional data is required and the user must upload an XML file containing this data. It is 
the responsibility of the ordering party to ensure that the correct fields are populated for the 
chosen card printing template or type. The user is asked to browse to a file location and specify 
a file to be uploaded. 

When a file is located, the user is asked to confirm the upload (“Are you sure you want to upload 
this card personalization file?”). On confirmation, the file is validated. If the file fails validation for 
any reason, then the file is rejected and the following message is displayed: 

“Error - The selected card personalization file is not valid.” 

If the file is valid, the file is uploaded and the following message is displayed: “The selected card 
personalization file has been attached to this order successfully.” 

When the user selects the Submit Card Order option, the details entered are validated. Any 
invalid details are highlighted, and the following error message is displayed: “Invalid order details 
entered - please re-enter the highlighted information.” The user is then required to re-enter the 
correct details as necessary. 


2.9 Order Vouchers 

Description The Business Account website allows authorized Agency users to process orders for vouchers. 
Security Lead Agency 

Business Account 

Requirements * The user accesses the Business Account website to order vouchers. 

• The user selects individual cards and assigns vouchers: 

• The user accesses the Card Summary List. The list will include all the card groups for the 
Business Account. 

• The user selects a group or groups from the list. 

• Alternatively, the user can enter card serial numbers if required. 

Table 7: Voucher Order Details 

r, . " Fields Constraints ~ " I ~7 

Data Element _ Re q uired Comments, Description, 

O-Optional Examples 

S - System Generated) 

Card Serial Number R The card serial numbers 

Not Required if the Group associated with the 

ID is entered Business Account. Drop¬ 

down list or entered by user 

Branch O Drop down list of all 

Not Required if the card branches for the agreement 
serial number is entered 


Data 

Element 

Category 
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Data 

Element 

Category 

Data Element 

Fields Constraints 
(R - Required 

0 - Optional 

S - System Generated) 

Comments, D 


G ” P 

O 

Not Required if the card 
serial number is entered 

Drop down list o 
for the selected 
Only the card se 
or Group can be 


Voucher Amount 

R 

This is the amou 
to be used by th 
cardholder. 


Voucher Revalue 

Type 

R 

Automatic, Rem 

If there is no vou 
amount entered 
will remain blank 
required. 


Voucher Automatic 
Revalue Products 

R (if Voucher Revalue 
Type is Automatic) 

A list of products 
revalued by the 


Period 

R 

Drop-down list of 2 entries 

This field will be 
with the full mon 
and year of the 
months for the p 
according to proi 
business rules. 


Voucher Purse 

Amount 

S 

The amount of v 
applied to the pu 
is the difference 
voucher amount 
pass purchase p 
required only for 
revalue voucher: 

• Otherwise, the user accesses the Import option and uploads a file that contains 
serial numbers and voucher amount. 

• If any errors occur in the file transfer, the process will stop. 

import file. Please inspect and correct the file before importing again.” 

• The user will be expected to make any necessary corrections to the file. 

• When the user has successfully completed the selection process, the user selec 
function to add the voucher order component to the current order. 

• The system prompts the user to confirm this is correct. 

Order E-purse Value 
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Business Account. 

• The user selects a group or groups from the list. 

• Alternatively, the user can enter card serial numbers if re 

• The user chooses the appropriate product. 


Table 8: E-purse Value Order Details 



If any errors occur in the file transfer, the process will s 
The system will display the following message: “Valida 
import file. Please inspect and correct the file before im 
The user will be expected to make any necessary corre 
When the user has successfully completed the selectio 
function to add the purse order component to the curre 
The system prompts the user to confirm this is correct. 
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Otherwise, the user accesses the Import option and uploads a file that contains the card 
serial numbers and pass product type. 

If any errors occur in the file transfer, the process will stop. 

The system will display the following message: “Validation errors have been detected in the 
import file. Please inspect and correct the file before importing again.” 

The user will be expected to make any necessary corrections to the file. 

When the user has successfully completed the selection process, the user selects the 
function to add the pass order component to the current order. 

The system prompts the user to confirm this is correct. 


2.12 Order Multi-ride Products 


Description The Business Account website allows authorized Agency users to process orders for multi-ride 
products and assign them to Business Account cards. 

Security Lead Agency 

Business Account 

Requirements The user accesses the Business Account website to order multi-ride products. 

The user selects individual cards to assign multi-ride products: 

• The user accesses the Card Summary List. The list will include all the card groups for the 
Business Account. 

• The user selects a group or groups from the list. 

• Alternatively, the user can enter card serial numbers, if required. 

• The user chooses the appropriate product. 
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Order Business Passport Products 


The Business Account website allows authorized users to process orders for Business Passport 
products and assign them to Business Account cards. 

Business Account Lead Agency 

The user accesses the Business Account website to order Business Passport products. 
Business Passport products are not monthly products. The validity period for these products 
runs from the agreement Approval Date to the Contract End Date. 

The user selects cards to assign Business Passport products: 

• The user accesses the Card Summary List. The list will include all the card groups for the 
Business Account. 

• The user selects a group or groups from the list. 

• Alternatively, the user can enter card serial numbers if required. 

• The user chooses the appropriate Business Passport product, as specified in the 
agreement. 


Table 11: Business Passport Order Details 



If any errors occur in the file transfer, the process will stop. 

The system will display the following message, “Validation errors have been detected in the 
import file. Please inspect and correct the file before importing again.” 

The user will be expected to make any necessary corrections to the file. 

When the user has successfully completed the selection process, the user selects the 
function to add the Business Passport order component to the current order. 

The system prompts the user to confirm this is correct. 
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2.14 Order Commercial Account Products 


Description 


The Business Account website allows authorized Agency users to process orders for commercial 
program products in the system. 

Note: There cannot be any other products on a card other than the commercial 
products. The commercial products are restricted to Business Accounts that 
have commercial agreements with WSF. 


Security 


Requirements 


WSF Lead Agency Only 

WSF Lead Agency commercial accounts only 

WSF Business Account agreement holders 

The user with a commercial account belonging to WSF or the Lead Agency accesses the 
Business Account website to order commercial account products. 

Commercial Account products are not monthly products. The validity period for these products 
runs from the agreement Approval Date to the Contract End Date. 

The user selects cards to assign commercial products: 

• The user accesses the Card Summary List. The list will include all the card groups for the 
Business Account. 

• The user selects a group or groups from the list. 

• Alternatively, the user can enter card serial numbers if required. 


Table 12: Commercial Account Order Details 


Data 

Element 

Category 


Data Element 


Fields Constraints Comments, Description, 
(R - Required Examples 

O - Optional) 




Card Serial Number 


Commercial Product 
Type 


R 

R 


Card serial numbers 


From a list of valid 
commercial product types. 


Otherwise, the user accesses the Import option and uploads a file that contains the card 
serial numbers and the commercial account product. 

If any errors occur in the file transfer, the process will stop. 

The system will display the following message, “Validation errors have been detected in the 
import file. Please inspect and correct the file before importing again.” 

The user will be expected to make any necessary corrections to the file. 

When the user has successfully completed the selection process, the user selects the 
function to add the commercial products order component to the current order. 

The system prompts the user to confirm this is correct. 


2.15 Business Account Order Summary Confirmation 


Description 


Security 

Requirements 


The Business Account website allows authorized users to confirm orders. If the order amount or 
products have not been altered from a previous order, then there is no requirement to confirm 
the order. 

Business Account 

Lead Agency Representative 

The user accesses the Business Account website to confirm the order. 

The Business shopping cart is displayed to the user. 
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The following summary details are displayed: 
o Order Number 

o Order Status 

o Date Created 
o Order Item 
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o Order Amount 

Selecting an individual order will take the user to the order details page. 

• The Business Account representative will be provided with an option to confirm one or 
multiple orders. 

• The system will prompt the user to confirm that the order is correct. 

. The fields are then locked to stop future editing. 

A Business Account or Lead Agency representative can unconfirm a previously confirmed order 
that has not yet been finally approved by the Lead Agency (through the Current Order Summary 
page). Whenever the order has been finally approved by the Lead Agency, the Business 
Account can no longer unconfirm the order. Unconfirming an order will set the order status back 
to Pending. 
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2.16 Card Account Summary 

Description The Business Account website allows authorized users to view card account information in the 
Business Account website. 

Security Lead Agency 

Business Account 

Requirements The user accesses the Business Account website to view the cards of an agreement. 

The user selects individual cards, card ranges, card status, card product, or groups of cards. 
Selecting a branch will automatically update the Group drop-down to just the groups for that 
branch. 





Card Serial Number A 

999 1 7002 

99917004 

999 1 700 5 


The 


Figure 36: Card Account Summary Page - List 

user can select any individual card to view the card account page fi 
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Table 14: Card Account Summary Details 


Data 

Element 

Category 


Data Element 


Fields Comments, Description, 

Constraints Examples 

(U- 

Updateable 


Card 

Summary 

List 


Card Serial Number 


O - Optional) 


Provided by 
the System 


Current, Fulfilled, Completed 


2.17 Card Account Page 


Description The Business Account website allows authorized users to manage the details of each individual 
card, if required. 

Security Lead Agency 

Business Account 

Requirements The user accesses the Business Account website to view cards which are issued as per the 
user's agreement. A user cannot view cards that are issued as part of other agreements. 

• The user selects individual cards or groups pf cards and order programs. 

• The user accesses the Card Summary List and selects individual cards from the list to 


Table 15: Card Account Page Details 
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Data 

Element 

Category 


Data Element 


Fields Comments, Description, 

Constraints Examples 

(U- 

Updateable 


Add products 


Block/Unblock Products 


N- Not 
Updateable) 


N Link to product order 

management page 
N Link to block/unblock 

products page 


NOTE: For cards with an inaccessible purse, no purse balance or status information will be 
displayed with the static text “E-purse is not available on this card.” in red. 



_ -- B 



551 

Product Name Remaining Value 


All-Day PugetPass $4.00 

Sound Transit Business Passport Valid to: 20 December 2009 - 

12 August 2020 


l ) 


Figure 37: Card Account Page - Detail 


The Card Account page is made up of three tabs across the top, Card Details, Card Order 
History and Transaction History. 

The Card Details tab displays information on the selected card as follows: 

• Card Serial Number - read only 

• Card status 

• Voucher revalue type 

• Current confirmed and pending orders (orders not yet approved) 

• Current products on the card 

This page allows the user to carry out the following functions: 

• Block/Unblock a card 

The user is prompted to specify a blocking reason. 


Commented [PR2]: 
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Card Account Details - block card 



Figure 38: Block Card - Confirmation 

A validation will be carried out to ensure that the card is not already part of a current range 
actionlist. If the card entered is part of a current range actionlist then the block/unblock will not 
be allowed. The error message displayed will be “The card cannot be blocked/unblocked as it is 
currently included in a block/unblock request for a range of cards”. 

• Disassociate a card (refer to 2.18) 

• Replace a card (refer to 2.19) 

• Update voucher revalue type 

- Request a purse refund (refer to 2.20) 

This allows the Business Account representative to switch the voucher revalue type for a 
cardholder. If the revalue type is automatic then the cardholder will receive the products as 
ordered by the Business Account. If the revalue type is remote then the cardholder may choose 
the products/value delivered online. Refer to section 2.28. 

• _ [Request a purse refund (refer to 2.20)1_ __ Commented [AS3]: COM-v26.0-001 

• Block/Unblock Products 

This function displays a list of all Business Account products for the current card and the current 
product status and reason for each. The Business Account representative can block/unblock 
products as required. When blocking or unblocking products, a reason must be selected from 
the relevant drop-down. 

NOTE: Purse blocks or unblocks will not be allowed for cards with purses set as Blocked - 
Inaccessible. 



Figure 39: Block/Unblock Products 


The Card Order History tab displays a sequential list of historic order details for the card. 

For reference, each of the transaction fields displayed on the Transaction History Detail page is 
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specified in Appendix B. 

The following details are displayed: 

• Order date created 

• Product ordered 

• Amount/Value 

• Redeemed (whether the product was actually loaded on the card) 

The Transaction History tab displays a sequential list (most recent first) of card activity history. 
The Transaction History tab will only be visible to Commercial Account Users, Lead Agency 
users, Participating Agency users, and the ESB. 

On selecting this function, the user is asked to enter the card serial number. 

When the card has been identified, the user will be asked to enter a date or date range (default 
will be last 30 days). When a valid date or range is entered, the following details are displayed: 

• A standard header always visible in the upper left portion of the screen, containing: 
o Card Serial Number 

o Cardholder Name 
o Business Account Name 
o Card Status (Active or Blocked) 

. A message stating that the most recent transactions may not yet be available for viewing 

• The transactions recorded for the card for the entered date range in reverse chronological 
order (most recent first). This includes fare payment and revalue transactions. The details 
displayed are: 

o Date/time 

o Transaction Description (e.g., Fare Payment, Revalue, Reversal, Rebate, Receipt 
number) The format for this field will be one of: 

■ Transaction Type (sourced from CD - max 31 chars) + "," + "Route" + Route 
Value (4 chars) 

■ Transaction Type (sourced from CD - max 31 chars) + "," + "Receipt" + Receipt 
Value (max 10 digits) - Note: For autoloads, receipt details will only be displayed 
for the initial setup 

■ Transaction Type (sourced from CD - max 31 chars) + "," + "Rebate ID" + 
RebatelD Value (max 10 chars) + "Rebate reason" + Rebate Reason Text (max 14 

o Location (of Start Of Journey or of Place Of Purchase) The format of this field will be 
Agency Short Name (max 3 chars) + "," + Location Name (max 37 chars). This field is 
sourced from Metrix. 

o Product (e.g., Purse, Reduced Fare Pass, Multi-ride 20 including Validity Month) The 
format for this field will be Product Name (sourced from CD - max 83 chars) + ", ” + 
Validity Month (max 9 chars) + + Year(yyyy) 

o Transaction Value for product sales and purse fare 

o Full Fare Trip Value (The full fare a cardholder would expect to pay for a single transit 
service if paying in cash) 

o Purse Balance (The remaining purse balance after the transaction is applied) 
o Actionlist Expiration Date (The date at which actionlist entries no longer appear in 
configuration data. This date will only be displayed for pending website sales as it is 
irrelevant for other transactions) 

o Device ID (Used for uniquely identifying receipts. The format of this field will be up to 10 
digits numeric) 

o Work Order Number (The unique system reference number associated with a work 
flow) 

o Payment Method (Autoload, Cash, Check, VISA, MCARD, Debit Card, Money Order, 
Purchase Order, Purse, Voucher) The format of this field will be one method per line 
(max 11 chars) + + last 4 digits of credit card This field will only be displayed for 

product purchases. 

o All fields will be sortable by the field header. 
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• Fields that can be sorted will have a ‘ditzel’ ( ) displayed in the title column. 

A ditzel indicates that a column can be sorted. 

A blue ditzel specifies that a column is sorted. 

The direction of the blue ditzel illustrates the current sort direction of a column. 

• An example of this display is included for reference: 



• Previous and next buttons will be displayed where applicable at the top and bottom of the 
transaction list to allow the user to scroll through the transaction list (if displayed on multiple 
pages). Moving back and forward through pages will retain the original search parameters. 

• Zero dollar value transactions will be displayed as a dash (not left blank or 0.00) Negative 
values will be displayed with negative signs (not parentheses). 

• The user can filter the displayed transaction by Sales, Usage, or All. 

The user can select to view transactions for different periods by choosing the ‘back’ button (on 

the page) and entering another valid date range. 

Sample screenshots of the transaction history page are included below for reference: 
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r > 

Card Account Details - for card 99920620 

Agreement 

1" Card Details jj’ Card Order Histpry Transaction History j 

Whitelist 

P ro gra ms^ ° SS * > ° 

► Electronic Voucher 

► Business Choice 

► Vanpool subsidies O 

Card Serial Number: 99920620 

Card Status: Active 

Group: Default Group -1051283 

Group Status: Active 

Refund Requested: □ 

Incomplete or in Progress Orders 

|1P- 1 

Product Valid for Amount 

► Voucher Rules 

► Order Rules 

Products on Card 


Product Name Remaining Value 

/^\ Shopping cart 

E-purse Value: $0.00 

► Orders© 

Regional Bus and Train Passport Valid to: 28 February 2012 - 28 

February 2013 


Add products BiQ.chAJabJQcK. PcQducla 

5 5 S 



Figure 40: Transaction History Page 
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2.18 Card Disassociation 


Description This function allows Business Account and Lead Agency users to disassociate business account 

Security Lead Agency 

Business Account 

Requirements The disassociate function is available to all program categories. The function is available via either 
the card account page or the cards page. This applies to both Lead Agency and BA users. 





! Cards page 


The disassociate button is displayed at all times (not just when there are search results). For 
disassociating multiple cards the button links to the Disassociate card(s) page. If there is only a 
single result from the card search or a card serial number is entered, clicking this button directs the 
user straight to the confirmation page (below). 

Card account page 
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Figure 43 Card account page 


The disassociate button is displayed at all times. The button does not direct the user to the 
disassociate card(s) page. It carries out the disassociate process and takes the user to the 
confirmation page. 

The Disassociate Card(s) page is accessible through the Disassociate Card(s) button on the Cards 
(search) page. For Lead Agent users, this option is only displayed when an Agreement is selected. 
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Disassociate Card(s) 



a file of cards to be disassociated 

1 Browse... | 




Figure 44 Disassociate cards page 

The user has the option of disassociating cards by: 
o Entering a single card number 
o Entering a range of card numbers 
o Selecting a Group 

o Importing a CSV or XML file of valid card serial numbers 
A confirmation page appears on entry/selection of card number(s). This varies depending on the 
number of cards to be disassociated. 

Clicking Cancel on this page directs the user back to the Cards page. 

For larger numbers of cards, the system will disassociate the cards as a deferred process. This is to 
avoid the user having to wait a long time for online confirmation. This process currently runs every 
hour. Note: In this case the cards are still visible online until the disassociation process is fully 
completed (the work order is created) and so potentially could be included in product orders. For 
disassociation of more than one card there will be a single work order for all cards. 

Where the disassociate process can occur immediately the following message will be displayed: 
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Figure 45 Disassociate confirmation page 

Clicking Cancel on the confirmation page directs the user back to the page where they initiated the 
disassociation (either the Card Account Details page or the Disassociate Card(s) page). Clicking 
Confirm on this page produces a success or failure message as below: 


Figure 46 Success/failure messages 




SUCCESS - 

e selected card(s) has/have been disassociated successfully. 


Where card serial numbers are entered (either a single CSN or a range) and there is an invalid card 
- none of the cards will be disassociated. This is different to the deferred process - where all valid 
cards w! be disassociated. The card serial numbers for those cards that failed will be displayed in 
the above error message. 

Where the disassociate process will be deferred the following message is displayed: 


■— (T) PLEASE CORRECT THE FOLLOWING ERROR(S): - 

-» The card range entered (1-999999) contains a card that does not belong to this 
agreement. 

Disassociate card from business account 

These cards will be disassociated shortly. After a card has been disassociated, any business account 
products on the card will stop working immediatelv .Onlv retail products or epurse on the card can be used. 

Do not place any product orders for these cards. 

The card(s) must be tapped on a card reader to complete the disassociation process. 


0 Email me when the process has completed. 



Figure 47 Deferred disassociation 

Once cards have been disassociated, whether individually or as part of a group/range, they can be 
re-associated individually. There is no need for the entire group/range to be re-associated. 
Disassociated cards can only be re-associated to the agreement they originally belonged to. If a 
disassociated card is replaced (at a CST or via the Call Center website) only retail products on the 
cards will be transferred to the replacement card. Business Account products will not transfer. 

For deferred disassociation, the user is given the option to have an email generated when the 
system process is completed. The check box is selected by default. The email address defaults to 
the Business Account primary contact email and can be edited. Only a single email address can be 
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entered. Any changes to the email address do not persist in the system. Note: The email address is 
the Business Account primary contact for both Business Account and Lead Agency users. 

The content of the email is as follows: 

SUCCESS 

Subject "ORCA Business Account - Card disassociation for " + 

currentAgreement.institutionalDetails.institutionName 

Body: 

"Dear" + contact.lnstitutionName + ",\n\n" + 

“The following [group was]/[file was]/[cards were] successfully 
disassociated:” 

[GROUP NAME] or [FILE NAME] or [CARD RANGE] 

"Thank you.\n\n" + 

"ORCA Customer Service" 

"Do not reply to this email. If you have questions, contact your Business 
Account Lead Agency Representative.”; 

FAILURENOTICE 

Subject : "ORCA Business Account - card disassociation for " + 

currentAgreement.institutionalDetails.institutionName 

Body: 


"Dear" + contact.lnstitutionName + ",\n\n" + 

"An error has occurred while disassociating cards for the following 
[group]/[file]/[range]: 

[GROUP NAME] or [FILE NAME] or [CARD RANGE] 

“The card(s) below have not been disassociated as they do not belong to “ 
+ currentAgreement. institutionalDetails.institutionName + 

[CARD SERIAL NUMBER] [CARD SERIAL NUMBER] 

[CARD SERIAL NUMBER] [CARD SERIAL NUMBER] 

[CARD SERIAL NUMBER] 

"All other cards have been disassociated successfullyAn" + 

"Thank you.\n\n" + 

"ORCA Customer Service" 

"Do not reply to this email. If you have questions, contact your Business 
Account Lead Agency Representative.”; 

For failures the email specifies the card serial numbers that failed. The failure reason is always the 
same - the card does not belong to the agreement. There is no action that the user needs to take. 
Cards that are valid will still be disassociated so the process will not fail - just certain cards will be 
excluded. 

For disassociation by file import, the CSV or XML file is validated immediately. If the file is invalid or 
any cards in the file do not belong to the current agreement then the upload will fail. 

Successful disassociation will result in actionlists being generated to remove the Business Account 
ID from the cards. 

Note: Disassociate actions are considered group movements (the same actionlist type is used for 
both). Therefore these actions are candidates for actionlist regeneration. If the actionlist entry for a 
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disassociate actions expires then the card will still not be available online. If the card is subsequently 
used, another action will be generated automatically. |This applies te both single and multiple card 

disassociations. Commented [PR6]: 


2.19 Card Replacement 


Description This function allows Business Account and Lead Agency users to replace business account cards. 
Security Lead Agency 

Business Account 

Requirements Replacement Process 
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The user is prompted to select a 

^6rca kcmi 





Figure 50 - Replace card sc 


e card will always be 


c) The Block reason will be displayed on all Business Account pages for all users as 
'Blocked - Replaced’. On Agency website and devices the reason will still display as 
'Blocked - Lost or Stolen Card’. Note: This only applies where the card has actually 
been replaced. If the card has only been blocked Lost or Stolen without a replacement 
then the Lost or Stolen reason will be displayed in all cases. 

d) For replacements with a new card the replacement fee will be sourced from the 
'Replacement card cost per card’ as set up by the Lead Agency on the Payment 
MethodsTTerms tab of the Business Account Agreement Administration page. 

e) Replacement fees will be applied as follows. All new agreements will have a default 
replacement fee. For Human Services agreements this will be $3. For all other 
agreement types this will be $5. The Lead Agency can change this fee (up or down to 


te user completes the replacement 
a) Replacement with new stock 
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Figure 51 - Replacement with new card stock 

In this case the user has the option to select card printing and personalization options. 
Note: Fees for these options are applicable for new card orders only. The Fee to be paid is 
the replacement card cost. The card customization fee (if applicable) will be displayed en a 
separate line. This fee will be automatically displayed (using scripting) if personalization is 
applied. 

b) Replacement with existing stock 



In this case the user is obliged to enter a valid card serial number (no CVN is required). The 
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card serial number entered must be valid for the current agreement (the agreement ID on 
the card must match the current agreement ID). 

Once the user confirms or makes payment then the following receipt page is displayed: 
a) No fee 


Card Replacement Order 

MR15-Whitelist#2 Lead Agency: King County Metro 




Figure 53 - Receipt page - no fee 

b) Fee applicable 

Note: For cards that are replaced with a new card, the new card serial number is not yet 
known (until it is produced at a CIPP). In this case the new element ‘Replacement card 
number:’ will not be displayed (as below): 



In all cases the print button sends the page to the user's default printer. There will be no 
specific page formatting applied for printing. 

- The Back link will return the user to the card account page for the replaced card. The card 
status will now show as blocked. 

The business rules for product transfers will be the same as for current system functionality. 
Non-expired passes (including business passport type passes and business choice/retail 
passes) can be transferred immediately and purse and multi-ride value will be transferred 
after the replacement waiting period. 

- There is no shopping cart in the replacement process. The user completes the process 
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from start to finish and cannot ‘continue shopping’. 

- For replacements using existing card stock, the replacement card must not be blocked. 
ERG strongly recommends that cards that have been used before are not used as 
replacement card stock (although the system will not specifically restrict this). 

- Replacement cards will be mailed to the agreement delivery address. 

Note: For Business Account users, if there is a fee applicable then payment will be required 
for both prepay and postpay agreements. 

For Lead Agency users, online payment will be required for prepay credit card agreements 

The proposed solution is that the replacement fee is applicable and payable online as 
follows: 

BA User - new card - replacement fee applicable 
BA User - existing card - no replacement fee applicable 
Agency user - new card - replacement fee applicable* 

Agency user - existing card - no replacement fee applicable 
*LA user - Post pay or noncredit card prepay agreements will be charged outside of the 
system (fee UD is generated for reporting purposes) 

Replacements with existing stock can fail validation for the following reasons: 

1. The replacement card already has products that are on the replaced card. 

error.cardReplacement.existingCard.products.cannotBeAdded = There are products 
from the current card that cannot be added to the existing card. {0}\n 
Where (0) can be in the lines of: 

<product_name> is not available for card <CSN> because the product is already on 
the card. 

<product_name> is not available for card <CSN> for the period of <validity> 

2. The replacement card has a purse that will go over $300 

error.cardReplacement.combinedPurseValue.exceedsMaximum = The combined 
Purse value of both cards exceeds the maximum Purse value. Please enter another 
Card Serial NumberAn 

error.cardReplacement.newCard.purseValue.exceedsMaximum = The Purse value 
of this card exceeds the maximum Purse value. Unable to do a card replacementAn 

3. Other general errors 

error.cardReplacement.existingCard.blocked = This card is blocked. Please enter 
another Card Serial NumberAn 

error.cardReplacement.existingCard.passengerType.expired = There are products 
from the current card that cannot be added to the existing card. The product requires 
a valid passenger type at the product start dateAn 

error.cardReplacement.existingCard.purseAccessible = The card can only be 
replaced by an existing card with an E-purse that is inaccessibleAn 
error.cardReplacement.existingCard.purselnaccessible = The card can not be 
replaced by an existing card with an E-purse that is inaccessibleAn 
error.cardReplacement.institution.cardDoesNotBelong = The card does not belong 
to this Business Account. Please enter another Card Serial NumberAn 
error.cardReplacement.invalid.replacementCSN = The Card Serial Number provided 
is invalid. Please enter another Card Serial Number. {0}\n 

error.cardReplacement.replacementCard.faulty= Card Serial Number {0} is invalid or 
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faulty. Please enter another Card Serial NumberAn 



error.cardReplacement.passengerType.doesNotMatch = The passenger type of the 
existing card does not match the current passenger typeAn 

error.cardReplacement.basicStockType.doesNotMatch = The card type of card {0} 

({1}) does not match the card type of card {2} ({3}). Cards can only be replaced with 
the same card typeAn 

General Replacement Rules 

It is the responsibility of the Business to maintain replacement card stock correctly. Any value or 
products previously on the replacement card may still be valid. Replacement card stock will have 
been issued already and will therefore already belong to a card group. The system will carry out 
validation on the replacement card to ensure that it is not registered to another cardholder, does not 
contain products that conflict with products on the original card, does not contain purse value that 
would result in the purse going over the maximum etc. These are the same validations carried out on 
product orders. 

Card replacements for KC Employee ORCA ID cards can only be initiated via the Business Accounts 
website. Replacement can be made from existing or new card stock. Where a replacement is being 
made using existing card stock, the card stock type must match the replaced card. Standard 
business rules for deferred transfer of value to the replacement card apply. Secondary printing may 
need to be carried out on the replacement card. 

Once the replacement card has been handed over from replacement card stock the Business can 
immediately carry out product orders for the card according to whatever programs they have set up. 

As long as the Business has the relevant programs set up then they can order any products for 
those programs. Whatever products were on the original card (both business account and retail) will 
be transferred to the new card. 

If the user chooses to replace the card with a new card then the order will be fulfilled by the Mail 

Center CIPP. The new card will be automatically reassigned to the Card Group that the old card 
belonged to. 

A new card order will be generated and is sent to the Mail Center CIPP for the replacement card. 

The new order will be visible in the Current Order Summary page. 

A note will be automatically added to the new card order stating “Replacement card order for card 

12345678 - Work Order 12345." 

There will be no confirmation or approval step for the Replacement Card order. The new card order 
will be automatically approved and cannot be updated. The new card order will be set to 
“Completed” when the CIPP has produced the new card. 

Where the old card is registered to a cardholder then the new card will also be registered to the 
same cardholder. 

After the Deferred Refund Period has elapsed, any e-purse and/or multi-ride products that were on 
the original card will be actionlisted to the replacement card. No voucher value (remote or automatic) 
will be transferred to the new card if not already redeemed. 

Card replacements will be included in the Card Replacements and Returns report. 

Business Account card replacements will be restricted for cards with purses set as Blocked - 
Inaccessible. These cards can only be replaced either with new stock with the purse blocked, or with 
replacement stock with the purse currently blocked. It will not be possible to replace a card with an 
inaccessible purse with a card with an accessible purse. 

2.20 

Purse Refund Request commented [pr?]: com-vm .0003 

Description 

This function allows Business Account and Lead Agency users to mark a card as refund requested. 

This allows the purse to be refunded at a CST. 

Security 

Lead Agency f Commented fASSl: com-v26.o-M3 
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Requirements 


On the Card Account page, a check box marked 'Refund Requested’ is displayed. The user can 
update the check box and then click on Save. This can be switched on or off as required. This will be 
visible and editable every time on the Card Account page ( to both BA and onlvto LA users). 


This flag signifies that the Business Account has accepted a cardholder request for a purse refund. 
The refund is carried out at a CST, which checks to ensure that this flag has been set. 


Once the purse is refunded the card is blocked (Surrendered) and this flag is locked as set and 
cannot subsequently be updated. 
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2.21 Create/Maintain Branches 

Description The Business Account website allows the creation and maintenance of branches for an agreement. 
Security Lead Agency 

Business Account 

Requirements Agreements can have many branches; however, there is a single login per Business Account 
(branches will not require separate login). 



Figure 55: Create Branch 


Existing branches may be removed by selecting the relevant check box and clicking Remove 
Branch. Multiple branches can be removed in this way simultaneously. The user will be prompted 
“Are you sure you wish to remove the selected branch(es)?” before the branches are actually 
removed. 

The user cannot remove a branch that has cards assigned to a group in that branch. The user must 
first move the cards to another branch/group (cards must belong to a card group and groups must 
belong to a branch). An agreement must have at least one branch (the last branch cannot be 
removed). 

When the user is ordering cards or products, the user will choose the branch and card group for the 
new cards/products. Choosing a branch automatically updates the Group Name drop-down. 
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Figure 56: New Card Order - Branch Name 
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2.22 Maintain Business Account Card Groups 


Description 

Security 

Requirements 


The Business Account website allows the creation of Business Account card groups. 

Lead Agency 
Business Account 

The Business Account or the Lead Agency user accesses the Business Account website to maintain cardholder 

• Create a new card group 

• Remove an existing card group 

• Move cards between groups 

• Block a Card Group 

• Unblock a Card Group 

• Import a Card Group 

• Export a Card Group 

• Update a Group Name or Description 

• Add a card to a group 

• Re-associate Card(s) 



Business Account Agreement Administration 


NICOLETTEKERR Lead Agency: Community Transit 


Create/Maintain Card Groups 

Branch | Choose 

Select a group(s) and choose an action: 



Figure 57: Maintain Card Groups 

Create new cardholder group 
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Remove a card group 

• The user selects a group and clicks on Remove group 

• The user is prompted to confirm the removal 

• The last group cannot be removed (each agreement must have at least one group) 







Figure 58: Remove Card Group - Confirmation 

Move cards between groups 

• The user selects the group they want to move card from and choose Move Card(s) 

• A list of all cards in the group is displayed and the user can choose which cards to move 

• A drop-down list of other branches and groups is displayed and the user must choose a group to move the cards 
to (cards must belong to a group) 
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Create Maintain Card Groups - move cards 


Move card(s) from group 


1. Select cards » 2. Confirmation 

Select cards to be moved from Default Group -1049959 

Branch: | Head office 

Group to Move Cards To * | choose v | 

Card Serial Number 

Page:t 

□ Select All 


□ 99917004 


□ 99917002 


□ 99917005 


□ Select All 

Page:1 


Figure 59: Move Cards 

Block Card Group (refer to 2.23) 

Unblock Card Group (refer to 2.24) 

Import A Card Group 

• The user selects the import option and they are asked to specify the file location and a name for the file 

• The user browses for and selects a file and clicks on Upload File 

• When a card group file is uploaded, it will be validated immediately to ensure it is in the correct XML format. 

Upon successful validation the user will be returned to the Upload Card Group File page. If the file fails validation 
it will be rejected immediately: 

o If the file is not an XML file, the message will be “The Card Group file you specified is invalid". 

O If the file is invalid, the message will be “Invalid XML contained within the Card Details file” 

• The content of the file will be validated as part of the Work Order Manager process. This process will validate 
each card in the file. 

• The file will continue processing during the content validation. Processing will occur as a background process 
following submission of the file via the Business Account Website. 

• If a card fails validation, the file will not be rejected, and the other cards in the file will still be processed. 

• Within an hour of a file validation failure, an email will be automatically generated and sent to the Primary 
Contact (Business Account Contact 1) for the agreement. 

• The email will include the uploaded file name and an error message. 

. It will not contain a hyperlink to the affected file or the affected card serial numbers. There will be a single email 
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generated for each file upload that fails validation. 

Successful card group movements will be reflected online, following completion of the next Work Order Manager 
cycle (currently one hour). 

Products can be ordered for cards at any time. When a product order is created for a Card Group, the product is 
assigned to the cards in the group when the order is created. Therefore it is possible that when an order is finally 
approved the cards in the group may have changed. This would be an example of a card validation exception as 
described below (see “Completed with Exceptions”). 


• Multiple files can be uploaded in the same period and will be processed in sequence. Card movement will be 
reflected online on the Uploaded Card Group File History page (below). 



Business Account Agreement Administration 

NICOLETTEKERR Lead Agency: Community Transit 

Upload Card Group File 

Fields marked with an asterisk (*) are required 
File ' * | ]| Browse... 1 


Uploaded Card Group File History 




Upload DateTiine 


£ Upload Status 


03/09/2011 07:13 PM 
03/09/2011 06:56 PM 
03/09/2011 06:55 PM 
03/07/2011 05:32 PM 
03/07/2011 05:27 PM 
02/15/2011 12:32 AM 


test 3 

uploadSucces 


added retailcard 


Completed 

Completed 

Completed 

Completed with Exceptions 
Completed with Exceptions 
Completed withExceptjons 


Figure 60: Import a Group 


• The page will list all files uploaded in the previous quarter and will display the following: 

o Date/time of the upload 

o File name (up to 50 characters) 

o Upload status 

o Hyperlink to details of any validation failure 

• Files will be listed in date/time order with the most recent first. Files older than the required time period will not be 
displayed or accessible. Files will be retained and displayed for a period of 3 months. If there are more files 
present than can be displayed on the page then multiple pages will be used. The user will have the ability to sort 
the file list on date/time and file status. 

• The File Status will be one of Pending, Completed or Completed with Exceptions. 

o Pending: 

This file has passed XML format validation, but the cards in the file have not yet been validated. A 
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file will be in this state for up to 30 minutes, 
o Completed: 

This file has been validated for XML format, and the cards in the file have also passed validation. 

Actionlist entries will be generated at the next CD generation, 
o Completed with Exceptions: 

> This file has passed XML format validation, and the cards in the file have been validated. 
Actionlist entries will be generated for cards that passed validation at the next CD 
generation. 

> For cards that have failed validation, a hyperlink is displayed and the user can view the 
details of the exceptions. Clicking on the hyperlink will display a list of all cards in the file 
that had exceptions, along with details of the exception. The user can decide what action 
to take (i.e. correct and resubmit, process cards manually, or do nothing). 

. Clicking on the hyperlink for a file with exceptions will display the following page: 


'Orca 


ctuseiOOl - Community Transit 



Business Account Agreement Administration 

NICOLETTEKERR Lead Agency: Community Transit 

File Exception Details 

File Name: added retailcard 

Upload Date/Time: 02/15/2011 12:32 AM 

Status: Completed with Exceptions 

Card Serial Number a Exception 

99925296 Card Serial Number is not valid for Business Account 1051083 





Figure 61: Import a Group - File Exception Details 


• This page displays all cards in the file that generated exceptions, along with a description of what the specific 
exception was. 

Export a card group 

• The user selects a card group and selects the export option 

• An XML file is generated containing group information and all card serial numbers for the group 
Update a group name or description 

• The user selects a group and clicks on Rename group. 

• The current Group Name and Group Description are displayed and can be updated. 

• The user selects Update to save the changes or Back to cancel the changes. 
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Figure 62: Rename a Group 


• This function is used mainly to allow customers to purchases RRFP cards at a Walk in Center and then have the 
card added to an existing Business Account 

• The card serial number and card verification number must be entered during the Add card process. The CSN 
and CVN will be validated and the card will be validated to ensure that it does not currently and never has 
belonged to any Business Account agreement. 

• The Business Account Group ID is actionlisted to the card. Once tagged, the card will be associated with the 
Business Account. If the card is not tagged then the process must be completed again manually. 

• This option will be available to both Business Account and Lead Agency users. 

• Only individual cards are allowed to be added to the program using this method. 

• This option will be available for any card type (Adult, RRFP etc.). 

• Current products on the card will be unaffected. Once the card has been added to the agreement, business 
products can be ordered for the card. 

• All agreements regardless of category can add cards to a program. 


^Agreements f 

Business Account Agreement Administration 

► Agreement Summary 

NICOLETTEKERR 

Lead Agency: Community Transit 

Wliitelist 

Card Serial Number: Q 

| Programs 

Card Verification 

Prostams Pa * SPOrt 

Number: 

' Programs Vollctler 

mmism 


Figure 63: Add a card 


Re-associate card(s) 

• The user selects a group and clicks on Re-associate card(s). 

• The user can enter a single card serial number or a card serial number range. 

• The card serial number(s) entered must be valid for the current agreement. 
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signed to the selected group. 


Business Account Agreement Administration 

daniell Lead Agency: King County Metro 

Re-associate Card(s) 

Single card serial ] 

number: I- 

OR 

Range of serial numbers 



2.23 Block Card Group 


Description The Business Account website allows a user to block a card group through actionlisting. This 
function can be used to block Business Account cards. 

Security Lead Agency 

Business Account 


Requirements 


should 


i the ability to abort this function and return to either the previous or main 


The user is asked to select the relevant card group. 

• If the user is a Lead Agency representative, an optional Business Account ID can be 
entered. 

• If the user is a Business Account representative, the Business Account ID is displayed. 

A message will be displayed stating that once the group is blocked then any business account 
products on the cards can no longer be used. 

After entry and validation, the following message will be displayed: 

• “The selected cards have been blocked.” 

The user can then return to either the previous or main menu. 
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2.24 Unblock Card Group 


Description 


Requirements 


The Business Account website allows a user to unblock a card group through actionlisting. This 
function can be used to unblock Business Account cards belonging to the selected Business 
Account. 

Lead Agency 
Business Account 

The user should have the ability to abort this function and return to either the previous or main 

• If the user is a Lead Agency representative, an optional Business Account ID can be 
entered. 

• If the user is a Business Account representative, the Business Account ID displayed. 

The user is asked to select the relevant card group. 

After entry and validation, the following message will be displayed: 

• “The selected cards have been unblocked.” 

The user can then return to either the previous or main menu. 


2.25 Change Password 


Description 

Security 

Requirements 


The Business Account website allows a user to change his or her login password. 

Lead Agency Full Access 

Business Account Access to change their own passwords. 

Following secure login, the user has the option of selecting the Change Password option. 

The user is prompted to enter the old password. 

The user is prompted to enter the new password (6-15 alphanumeric characters). 

The user is prompted to enter the new password again for verification. An error message is 
displayed if the entry does not match the previous entry (“Error - the new password entries do 
not match - please re-enter.”) or if the old password is incorrect (“Error - the old password 
entered is incorrect - please re-enter.”), and the user must restart the process. 

The user is advised not to disclose the password to anyone. 

In all cases, the passwords entered are masked and displayed as asterisks. 
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2.26 Generate Reports 


Description 


Security 

Requirements 


The Business Account website allows the user to generate various system reports, such as: 

• Customer Sen/ice Reports 

• Finance Reports 

• Business Account Reports 

• Ridership Reports 

• National Transit Database Reports 

• System Maintenance Reports 

An additional login may be required. Only groups for which the current user has access 
privileges are displayed. 

Each report group contains a number of individual reports. The user is asked to enter any 
required report parameters, and the report results are then displayed on screen. These can then 
be printed if required. 

Agency Full Access 

Business Accounts representative (for reports on their own data) 

On selecting this function, the user is redirected to Crystal Reports ePortfolio and is presented 
with the Login page shown in Figure 64. 



2.27 Logout 


Description The Business Account website allows a user to log out to enable other users to use the same 
computer. 

Security Lead Agency 

Business Account 


Requirements When the user clicks on the Logout option, any current user activity is aborted and the user is 
logged off. The Logout function is available on all Business Account website pages. 

The Login page is displayed, and an authorized user must login before any further user activity 
can be carried out. 

Users may also be logged out if their session is inactive for a configurable period. In this case, 
the user will be asked to log in again and will be provided with Customer Service contact details. 
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2.28 Update Autoload Type 

Description The Business Account website allows users to switch the loading of vouchers from remote to 
automatic (cardholders can switch to remote via the cardholder website). 

Security Lead Agency 

Business Account 

Requirements On the card account page the current voucher revalue type is displayed for the card. If the 

voucher revalue type is REMOTE then the Lead Agency or Business Account user can set this 
to AUTOMATIC (only the cardholder can set the voucher revalue type to REMOTE). If the 
voucher revalue type is already AUTOMATIC then no option is displayed for the user to change 

NOTE: If the Lead Agency restricts the revalue types available to a single option then this 
function is not available. For example, if the Lead Agency sets the voucher revalue type for the 
agreement to AUTOMATIC (only) then the Cardholder or Business Account cannot change that 



^-N 

Card Account Details - for card 99914007 

^ Card Details ^ Card Order History | Transaction History | 


Card Serial Number: 99914007 


EE1 

^ Shopping Can 

Current Orders - for card 99914007 

" sZCo 

" ::zr 

Purs. Vaiue: SI 00.00 


Figure 65: Update autoload type 


Agreement Order 

Revalue Type Revalue Type 


Remote 


Remote 


Automatic 


Automatic 


Revalue Type 

Remote - this cannot be changed by the cardholder 
to Automatic 


Automatic - this cannot be changed by the cardholder 
to Remote 


Both 


Automatic 


Automatic - default 
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Remote - cardholder can update to Remote. If card 
has been set to Remote, this is not overridden with 
the next order (even though the order's revalue type is 
Automatic). 


2.29 Maintain Vanpool Subsidy Table 


Description The Business Account websites allows authorized users to view and adjust fare coverage table 
details. 

Security Lead Agency 

Requirements On selecting this function, the following information will be displayed. 

• Lead Agency Business Account ID - not amendable 

• Business Account Name 

. Business Account ID - unique ID for each Business Account - not amendable 
. Branch (a drop down list of all branches for the agreement) 

• Card Group name 

. Currently subsidy level ($ or %) 

The user can update subsidy details for any of the groups. The user can only enter one of the 
subsidy fields ($ or %). Entering one should blank out the other. 


Table 17: Business Account Vanpool Fare Coverage Information 


Lead Agency Business Account ID 


Business Account Name 


Business Account ID 


Group ID 


Vanpool Monthly Rider Fare 


Percentage of Vanpool Monthly 
Rider Fare 


Lead Agency Business Account ID 


The name of the Business Account 


Business Account ID 


The group that the subsidy applies to. 

The amount of the vanpool monthly fare the Business 
Account covers for its valid vanpool passes. 

The percentage of the vanpool monthly fare the 
Business Account covers for its valid vanpool passes 


SEA-01654 Vix Confidential ©Vix 2013 Page 95 of 

Revision 27.0/Apr 29, 2013 To be disclosed only to Agency personnel who 

have a need to know 








Central Puget Sound 

Regional Fare Coordination System 


Security Level: 


ORCA Institutional Program 
Website Functional Specification 


2.30 Contact Us 


Description 

Security 

Requirements 


This function allows users to submit an email message to their Lead Agency ( 
Public access and Business Account 

On selecting this function from the public website (not logged in) the following 

• Contact Name - mandatory 

• Business Name - mandatory 

• Business Street Address - mandatory 

• City, State, Zip (single field) - mandatory 

• Email address - mandatory 

• Telephone 

• Subject - mandatory 

• Message - mandatory 


• central contact. 



The user can complete the message and click on Send message. This message will then be sent 
to the emplover.services@kinQcountv.gov email address. 

On selecting this function from the private website (logged in) the following fields are displayed: 

• Business Account Name - automatically populated 

• Lead Agency Name - automatically populated 

• Contact Name - mandatory - populated with Business Account Contact 1 details 

• Email address - mandatory - populated with Business Account Contact 1 details 

• Telephone - populated with Business Account Contact 1 details 
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• Subject - mandatory 

• Message - mandatory 
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3 ESB Business Account Functions 


3.1 Maintain Business Account Program Rules 


Description 

Security 

Requirements 


The Business Account website allows the maintenance and setup of generic Business Account 
Program rules for agreements. This applies to all agreements. 

ERG Service Bureau (ESB) 

The authorized user accesses the Business Account website to maintain the Business Account 
Program rules. 

• Voucher Rules (This will be the default for all voucher programs for the region.) 

• Enter the following voucher information: 

o Minimum and maximum voucher amounts 
o Remote revalue or automatic revalue, or both 

• Business Choice Program Rules (This will be the default for Business Choice Programs for 
the region.) 

. Enter the following Business Choice and Voucher Program product information: 
o The maximum dollar amount to be allowed on a purse revalue 
o The pass products allowed (if this is not provided, then all products can be used) 

• Online Payment Rules 

• Enter the following order rule information: 
o Orders do not exceed $x, or 

o Orders have not changed +/- $ from previously approved order 

• Business Passport Rules 

• Enter the following Business Passport rule information: 
o Product Name 

o Payment Type Allowed (Per-Trip, Flat Rate) 
o Agencies participating in the Business Passport product 
Note: WSF will not be participating in the Bus/Train Business Passport pass. 
Therefore, by default WSF will not be included in a billable linked trip, 
o Agencies not participating in billable linked trips. 

Note: WSF will be participating in the Bus/Train/Ferry pass. However, for billing 
purposes, WSF will not be party to a billable linked trip. 

Only functions for which the user has access rights will be displayed. 
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4 Lead Agency Accessible Agency Functions 

4.1 Lead Agency User Login 

Description The Business Account website allows Agency users to login. All Agency users must have been 
set up with the appropriate system access rights, and with a unique username and password. 
Business Account website Users must have the role of Lead Agency representative. 

Security Lead Agency 

All Agencies (Read only access). This applies to all functions. 

Requirements The user will be asked to enter a username and password (6-15 alphanumeric characters). 

If the entries do not correspond or are invalid, then an error message will be displayed and the 
user will be asked to retry. There is a maximum of three unsuccessful login attempts. After three 
failures, the user account will be locked and must be unlocked by an administrator. 

Note: A failed login attempt is one in which the username is correct but the password 
is incorrect. Incorrect username entries do not count toward failed attempts. 

If the login is successful, the user can carry out the following functions: 

• Create Business Account Agreement 

• Select an existing agreement 

• Change Password 

• Generate Reports 

• Logout 

To select an existing agreement, the user can either select from a drop-down list of all Business 
Account Names or carry out a search using any or all of the following fields: 

• Business Account ID 

• Lead Agency Business Account ID 

• Lead Agency Name (drop-down list of Agency names) 

• Participating Agency Name (drop-down list of Agency names) 

. Tax ID 

. Business Account Name 

• Agreement Type 

• Branch Name 

• Wildcard searches are available on all text fields. 
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The user selects 'View' and the following details are displayed for all agreements that match the 
entered search criteria: 

. Business Account ID 

• Lead Agency Business Account ID 

• Lead Agency Name 

• Business Account Name 

• Status 

• Program Category 


3 items found, displaying all items. Page: 1 

Business a Lead Lead Business Status Program 

Account ID T Agency a Agency ^ Account ^ w Category T 

Business 7 Name Name 

Account ID 

1050499 King County DEVI-046316 Declined Unspecified 

Metro 

1050500 King County nic 002 Declined Unspecified 

Metro 

Figure 69: Search For An Agreement Results Page 

(Note that if there is just a single match, this step is bypassed and the functions listed in Table 
18 are displayed.) If no matching agreements are found, the user receives the message: “There 
are no Business Account Agreements that match the criteria entered - please retry.” The user 
can refine the search or choose another option. 


Fields that can be sorted will have a ‘ditzel’ ( ) displayed in the title column. 

A ditzel indicates that a column can be sorted. 

A blue ditzel specifies that a column is sorted. 

The direction of the blue ditzel illustrates the current sort direction of a column. 

The user can now select an individual agreement. When an agreement has been selected, the 
functions listed in Table 18 are displayed. 
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4.2 Business Account Agreement Administration 

Description 

Security Lead Agency (Full Access) 

All Agencies (Read only access ) 

Requirements Following selection of this function, the user will have the fields listed in Table 19 displayed. 

Table 19: Business Account Agreement Administration Functions 


Data 

Element 

Category Data Element 

Business 

Account Business Account 

Agreement name 

Business Account ID 


Program Category 


Status 

Agreement Type 


Fields 
Constraints 
(R - Required 
O - Optional 
S- System) 


The name of the Business Account 
The Business Account ID 


The Business Account Tax ID 
The agreement is an Employer, 
Campus, Human Service, or 
Commercial program. 


Extended (Active), Suspended 
(Active), 

Terminated 
Online or Manual 


The user is provided with the Business Account to be maintained. 

The details listed in Table 19 can be updated. The user selects the function to update the details. 
(The user should be able to leave the process without having to complete the required fields. The 
Business Account Agreement Application Approval function will validate whether required fields 
have been completed. This validation is not applied for pending agreements.) 


Agreement details are 
tabs across the top of 
been entered will not t 


series of pages. There will be a number of header 
page to show the user where they are. Data that has already 
if the user moves to a different page. 


Business account Contact I Program 

information | infoirnatign || information 

Figure 70: New Agreement Header Tabs 

There will also be Back and Next buttons to allow the user to move between pages if 
required. Clicking Next will automatically save any information entered on the current page. 
Clicking the Cancel button will abort the application without saving any data. 
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Figure 71: New Agreement Buttons 

The system prompts the user to confirm this is correct. 

The user will be provided with the following options: 

• Maintain Business Passport Program Rules 

• Maintain Business Choice Program Rules 

• Maintain Vanpool Fare Coverage Table (Lead Agency access only) 

The user will be provided with the following options according to the allowable state: 

• Renew/Extend/Suspend/Terminate Business Account Agreement 

• Maintain Business Account Groups 
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4.3 Access Knowledge Base 


Description The Business Account website links to the Knowledge Base to assist in customer queries. 
Security Lead Agency 

Business Account 


Requirements 


The Business Account FAQs portion of the knowledge base will be visible to all users. This will 
be displayed as a static page on the website and will be accessible to the public without having 
to log in. The data in the FAQs is managed by a knowledge base administrator via the agency 
website. Updates to the FAQs are real time and will be reflected on the Business Account 
website immediately. 


4.4 Upload Card Printing Template 


Description 


Security 


Requirements 


The Business Account website allows an authorized Lead Agency user to upload files containing 
card printing templates (ID Works formats) for card ordering. These templates are used for 
Business Account card orders that have common unique graphics or require special card 
personalization (secondary printing). This function will be carried out by the Lead Agency for the 
particular Business Account. This function should be used for initial set up of templates 
(Standard/Campus/ Business Account Program Regional Reduced Fare Permit (RRFP)). 

Lead Agency 


This section will be hidden if an Agency is in the context of another Agencies' agreement (e.g. a 
Participating Agency). 


On selecting this function, the user is asked to select which Business Account this template is for 
(drop-down list of Business Accounts for the current Agency). The user is then asked to enter 
the following: 


• Card Printing Template Name (free format alphanumeric - mandatory) 

• “Please enter a name for this template. This name will appear on the card order page for 
future card orders and should clearly identify the card printing template.” 

• Card Printing Template Description (free format alphanumeric) 

. “Please enter a description for this template. This description may specify which fields are 
included in the template, their formats and which are mandatory.” 

The user must then browse to a file location and specify a file to be uploaded. 

When a file is located, the user is asked to confirm the upload (“Are you sure you want to upload 
this card printing template?”). 


On confirmation, the file is validated. If the file fails validation for any reason, then the file is 
rejected and the following message is displayed: 


• “Error - The selected card printing template is not a valid file.” 

If the file is valid, the file is uploaded and the following message is displayed: “The selected card 
printing template has been uploaded successfully.” 
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4.5 Business Account Agreement Application Approval 

Description The Business Account website allows approval of Business Account agreements. 

Security Lead Agency. 

Requirements The system displays the selected agreement, (online or manual agreement). 

The Lead Agency representative enters the Lead Agency Business Account ID. 

The system shows the applicable details. 

The Lead Agency representative has the option to approve or decline the pending agreement (there 
must be at least one Business Account program set up before an agreement can be approved). 
When the Lead Agent selects the 'Approve' button the system will validate all the required fields in 
'Details' for that Business Account. This includes Business Account Information, Contact 
Information, Program Information, Payment Methods/Terms, and Approvals and Dates pages, which 
will have been populated with details entered during the Register New Agreement Process. 

If any of the required fields are not valid or a match is not found, an appropriate error message is 
displayed, and the user is asked to correct these error(s). 

A new element will be included on this page that shows the product selection made previously. This 
will be one of 'Business Choice', 'Business Passport’ or ‘I don't know”. Once the application is 
approved or declined, this element will no longer be stored or displayed (the Lead Agency is forced 
to create the relevant programs before approving a new agreement). 

Any message text entered by the user on the sign up page will be displayed. This will be read only. 
Once the application is approved or declined, this message will no longer be stored or displayed. 
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Figure 73: Pending agreeme 


When approved the state of the agreement will move from pending to active. When declined the 
state of the agreement will move from Pending to Declined. 

Whenever an agreement state changes, the Status Date will be updated accordingly. 

Agreements that are declined can subsequently be approved. In this case the user must first restore 
the agreement to a state of Pending and then approve it as above. 


Status: Declined 

Status Date: 01/01/2008 

Agreement Type: Manual 


Figure 74: Restore Declined Agreement 
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• The Lead Agency representative will be provided with an option to cancel an order. 

• The Lead Agency selects the function to approve all orders. A secondary request w 
made from the system to confirm this is correct. 

• The fields are then locked to stop future editing. 

Orders can be approved only for active/approved Business Account agreements. 

If the order amount or products are within the auto-approve rules, there is no requiremer 
approve the order. 


Maintain Business Passport Programs 


The Business Account website allows authorized Lead Agency users to administer a Bu 
Passport program for an agreement. 

Lead Agency 

The user sets up or maintains the Business Passport product or products to be used in t 
agreement, using the details shown in Table 22. 


Table 22: Business Passport Product Details 


Data Element 
Category 


Effective date 


Month/Year 


Saved rates 


Month/Year 


Product 


Product 


Data Element 


Comments, Desc 
Examples 


The effective Month 
year to apply the pa 
type and rates to. Ai 
existing information 
period will be overw 
A drop-down of peril 
have previously bee 
entered. Selecting a 
period allows the us 
update or clear rate: 
have already been c 
From a drop-down li 
Business Passport [ 
The payment type tc 
used for the Businet 
Passport product, cl 


Payment Type 
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Business Account Program Administration 


CTS namel 


Lead Agency: King County 
Metro 


Business Passport Program 


Select the Business Passport products and payment types from the list below, then click 'Show 
Rates' to set the agency rates for each product 

Removing a product from the program or changing its payment type will clear its rates 

Effective date (MM/YYYY): RT~1 / | 2007 | 


Saved rates: ;j anuar y 2008 v ^^^9 

April 2008 


Payment Rates 
Type 


□ Regional Bus And Train Pass 
G Regional Pass 

D Community Transit Pass 

□ Everett Transit Pass 

□ King County Metro Pass 

□ Kitsap Transit Pass 

□ Pierce Transit Pass 

□ Sound Transit Pass 



Figure 75: Business Passport Setup - Main 

The default period displayed is the current month. If any rates have been entered for the current 
month, then they will be displayed. Previously saved rates for future periods will be displayed in 
the Saved rates drop-down (rates for historic periods will not be displayed). If the user selects 
another period from the Saved rates drop-down and clicks Update, the relevant payment types 
will be displayed. 

To enter new rates, the user selects a product check box to enable that product. This enables 
product ordering capability for that product. The user can either leave the Effective Date as the 
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current month or specify a future period. However, if a product is active, rates must be saved for 
at least the current month. 

If the product is Flat Rate, then: 

• For an Agency participating in the flat rate product, enter the following information: 
o 1) If Use ridership is selected, enter a single monthly dollar amount. 


Business Account Program Administration 

Business Passport Program - Product Details 

Enter the Business Passport product details below (leave fields blank for agency not 
participating in product): 

Use Ridership 0 

Monthly Amount $ | ~| (Required if Ridership is selected) 



Figure 76: Business Passport Setup - Flat Rate with Ridership 

2) If Use Ridership is not selected, enter a Fixed Value dollar amount for Agencies as 
required. 
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Business Account Program Administration 

Business Passport Program - Product Details 

Enter the Business Passport pr 
participating in product): 

Use Ridership □ 

Regional Bus Ami Train 
Agency 

Community Transit 
Everett Transit 
King County Mstro 
Kitsap Transit 
Pierce Transit 
Sound Transit 


lat Rate 
ixerl Value 


Figure 77: Business Passport Setup - Flat Rate with no Ridership 

If the product is Per-Trip, then: 

• For an Agency participating in the per-trip product, enter the following information: 
o 1) If Use Ridership is selected, a discount rate % for Agencies as required. 


SEA-01654-Vix Confidential ©Vix 2013- 

Revision 27.0/Apr 29, 2013 To be disclosed only to Agency personnel who 

have a need to know 


Page 117 of 160 





















Central Puget Sound 

Regional Fare Coordination System 


Security Level: 


ORCA Institutional Program 
Website Functional Specification 


Business Account Program Administration 


Business Passport Program - Product Details 

Enter the Business : Passport product details below (leave fields blank fgr agency not 
participating in product): 

Use Ridership 0 


Regional Bus And Train Pass 

Community Transit 
Everett Transit 
King County Metro 
Kitsap Transit 
Pierce Transit 
Sound Transit 


Per Trip 
Discount Rate 

I 1 % 

I 1 % 

I 1% 

I k 

I 1 % 

I 1 % 




Figure 78: Business Passport Setup - Per-Trip With Ridership 

2) If Use Ridership is not selected, a monthly amount for Agencies as required. 
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Business Account Program Administration 


Right to Ride Program - Product Details 

Enter the right to ride product details below (leave fields blank for agency not 
participating in product): 


Regional Bus And Train R2R Pass 

Per Trip 

Agency 

Amount 

Community Transit 

4 1 

Everett Transit 

d 1 

King County Metro 


Kitsap Transit 

d 1 

Pierce Transit 

d 1 

Sound Transit 

si 1 





Figure 79: Business Passport Setup - Per-Trip with no Ridership 
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4.8 Maintain Electronic Voucher Programs 


Description 


Security 

Requirements 


The Business Account website allows the following: 

• Maintenance and setup of voucher programs for an agreement 

• Canceling of Electronic Voucher Program for an agreement 
Lead Agency. Full Access 

The authorized Lead Agency user accesses the Business Account website to create or cancel 
the electronic voucher programs. The following information is supplied: 

• Voucher Program Name 

• Voucher Amount 

If the Business Account is supplying the cardholder voucher funds to the purse, then: 

• Set amount to the purse 

• Otherwise, if the Business Account is supplying the cardholder voucher funds to pass or 
multi-ride products, then select the product or products. A filter will be provided to allow the 
user to limit the display to Regional, All or specific Agency products. 


Business Account Program Administration 


CTS namel Lead Agency: King County Metro 


Electronic Voucher Program Rules 


Voucher Program Details 

Fields marked with an asterisk (*) are required 


Voucher Program Name: 


Voucher Amount: 


Voucher Revalue Type: Both 

The purse is the default product. If no products are selected the 
Voucher amountwill be added to the purse. If the Voucher amount 
selected is greater than the retail price of the chosen products the 
balance will be added to the purse. The retail price of the selected 
products cannot exceed the Voucher amount. 


Available Products: 

All Products | Regional | CT | ET | KCM | KT | PT | ST | WSF 
□ All Products 
Regional Products: 

All Products | Regional | CT | ET | KCM | KT | PT | ST | WSF 
[g All-Day PugetPass $4.00 
[31 PugetPass $0.50 


$ 8.00 

$18.00 


Figure 80: Electronic Voucher Product Filter 

Note that the total of the products selected cannot exceed the voucher amount. 
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When the user has completed the process: 

• The user selects the function to approve the data entry/canc 

• The system prompts the user to confirm this is correct. 

Maintain Business Choice Program 

This function controls the rules for Business Choice for an agree 
agreement. The information will default to the Business Account 
can be used to vary an online or manual agreement Business Cl 
Lead Agency. Full Access 
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4.10 Maintain Business Account Agreement Rules 


Description 

Security 

Requirements 


The Business Account website allows the maintenance and setup of generic Business Account 
Program rules for all agreements for the current Lead Agency. 

Lead Agency 

The authorized user accesses the Business Account website to maintain the following rules: 

• Automatic Order Confirmation rules 

• Orders do not exceed $x ,or 

• Orders have not changed +/- $ or x% from previously approved order 

• Voucher rules (This will be the default for voucher programs for the agreement.) 

Enter the following voucher information: 

• Minimum and maximum voucher amount 

• Remote revalue or automatic revalue, or both 

Only functions that the user has access rights to will be displayed. 



Lead Agency: King County Metro 



*feg- I 






Figure 82: Order Rules 


4.11 Extend/Renew/Suspend/Terminate Business Account 
Agreement 

Description The Business Account website allows any of the following: 

• Extension. Extensions are required during the negotiation of the renewal of the existing 
agreement. The Lead Agency is able to extend an agreement. The system will record audit 
and authorization details. 

• Renewal. Manual agreement renewals happen usually once a year, but online agreements 
have no end date. To assist with the management of agreements, the ability to “clone” any 
previous agreement is available, meaning that the existing agreement can be copied to be 
effective beyond the original agreement period. Only the Lead Agency can renew an 
agreement. Any authorized person at the Lead Agency associated with the Business 
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Account can renew agreements. 

• Online Agreement. Because online agreements do not have to have an end date, business 
rules within Agencies will be used here for review. Only the Lead Agency can renew an 
agreement. Any authorized person at the Lead Agency associated with the Business 
Account can renew agreements. 

• Suspension. This is used for the temporary suspension of an agreement, not for a 
termination. A suspend may progress to termination. The suspending of an agreement 
would result in the removal of the Business Account from the Business Account Whitelist. 
Only active agreements can be suspended. 

• Termination. The termination of an agreement would result in the removal of the Business 
Account from the Business Account Whitelist. Only active agreements can be terminated. A 
termination may occur in one of the following ways: 

o Forced by Lead Agency 

o Requested by Business Account 

o Forced by expiration date 

For terminated agreements, Lead Agency users will have access to the following data : 
o Agreement details 
o BA whitelist details 

o Card group and card details 

o Program details (Business Passport Programs, Electronic Voucher Programs, 
Business Choice Programs, Vanpool Subsidies) 
o Order details 

Action buttons will be hidden when the agreement status is terminated. Furthermore, the 
display mode will be read only (similar to participating agencies viewing other Agency 
agreements. The BA user will not be able to login when the agreement is terminated 
(current implementation). 

Security Lead Agency 

Requirements Display the entered agreement (online or manual agreement). 

The user will select one of the following actions: 

• Extend 

• Renew 

• Suspend 

. Terminate 

• If the user selects Extend, then 

• The information shown in Table 24 is entered. 
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When the date has been entered, confirm the termination. 

Confirm Change 

Do you really want to Terminate this agreement? 



Figure 83: Terminate Agreement Confirmation 

The system will prompt the user to confirm again before the system finalizes the termination. 
Only functions for which the user has access rights will be displayed. 


Figure 84 provides an overview of the possible agreement status flows. 



Figure 84: Agreement Status Flow 

The status types that are available depend on the current status of the agreement. Table 
28 lists the available options. 


Table 28: Available Status Changes for Agreements 


Current Status 

PENDING 

DECLINED 

ACTIVE 


EXPIRED 

EXTENDED 

SUSPENDED 


TERMINATED 


Can Be Changed To 


ACTIVE, DECLINED 


PENDING 


EXPIRED (set by system), TERMINATED, SUSPENDED, 
EXTENDED, ACTIVE (renewal) 


EXTENDED, ACTIVE, TERMINATED 


ACTIVE, SUSPENDED, EXPIRED (set by system), TERMINATED 


ACTIVE (system or manual), EXPIRED (set by system), 
TERMINATED 


The options available on the Agreement Summary page will be APPROVE, EXTEND, RENEW, 
TERMINATE, SUSPEND, and REACTIVATE. These will be controlled based on the current 
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agreement status and displayed only if relevant. The user can renew/reactivate/approve an 
agreement only if no other agreement is ‘current’ (as per the diagram in Figure 84). 


4.12 Manage Business Account Whitelist 

Description The Business Account website allows the temporary suspension of a Business Account, branch 
or group. 

Security Lead Agency 

Requirements The user selects to suspend or reinstate a Business Account, branches or groups of cards. 
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Figure 85: Business Account Whitelist 


When the miormation has been entered, the user confirms the suspension/reinstatement. 

When a Business Account is suspended, all products for that Business Account are automatically 
also suspended. When a Business Account or branch is reinstated, card groups for that Business 
Account revert back to their previous state. 

Any new groups will automatically go onto the Whitelist as long as the Business Account is 
whitelisted. 


4.13 Create Business Account Agreement 

Description The Business Account website allows the Lead Agency to set up a new agreement. Agreements 
set up in this manner are Manual agreements. Agreements set up by the institution online are 
Online agreements. 

Security Lead Agency 

Requirements The Lead Agency user is presented with the following information shown in Table 30. 
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Appendix A Agency Location Matrix 

When a public website user is applying for a new agreement this information is used to determine 
the correct Lead Agency to apply to the agreement. This information is not necessary or visible 
when a new agreement is being created by a Lead Agency. 

Table 31: Lead Agency Derivation Worksheet 


Regional Fare Coordination Project 


KCM 

KCM 


KCM 

KCM 

KCM 

KCM 

KCM 

KCM 


KCM 

KCM 

KCM 

KCM 

KCM 

KCM 


KCM 

KCM 

KCM 

KCM 

KCM 

KCM 


98001 

98002 


98010 

98011 


98019 

98022 


98025 

98027 


98035 

98038 


Updated: 9-Jan-06 
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Lead Agency 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

KCM 

CT 

CT 

CT 

CT 

CT 

CT 

CT 

ET 

ET 

ET 

ET 

CT 

CT 

CT 

CT 

CT 


Zip Code 

98165 

98166 
98168 


98174 

98175 
98177 


98181 

98184 

98185 


98191 

98194 


98199 

98224 

98288 

98223 


98021 

98241 


98205 

98201 


98204 

98252 


98270 


County 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

King 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 
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Lead Agency 


Zip Code 


County 


CT 

CT 

CT 

CT 

CT 

CT 

CT 

CT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

KT 

PT 

PT 

PT 


98271 

98272 
98043 
98275 


98296 

98292 


98310 

98311 

98312 


98322 

98337 


98346 

98353 

98359 


98367 


98380 

98315 


98386 

98392 


98391 


Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

Snohomish 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

KITSAP 

Pierce 
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Lead Agency 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 


Zip Code 

98321 

98323 

98327 


98330 

98332 


98338 

98344 

98348 


98351 

98352 


98371 

98372 

98373 


98385 


98394 

98395 


98398 

98401 

98402 


98405 


County 
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Lead Agency 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 

PT 


Zip Code 

98406 

98407 

98408 


98412 

98413 
98415 


98418 

98421 

98422 
98424 


98431 

98433 


98439 

98442 

98443 

98444 

98445 

98446 

98447 
98450 
98455 
98460 
98464 


98467 

98471 

98477 


98493 


County 
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Appendix B Transaction History Source Data 

Table 32 lists the Transaction History fields displayed on the Transaction History Page (refer to section 2.17 Card Account Page) 
of the Business Account website. 

The table shows the system source of each field, the relevant display formats, which party is responsible for updating the data, 
and any exception information associated with the field. 

• The system includes information to allow cardholders to identify where there may be a gap in the sequence of transactions 
displayed. The system carries out the following checks: 

1. For purse transactions: 

(a) The system displays the purse transaction sequence number (PTSN) for all purse transactions. 

(b) All purse transactions have the suffix (#NNN); where NNN is the PTSN for the specific transaction. Maximum value of 
NNN is ~ 65000. 

(c) Static text is displayed at the top of the transaction history page explaining the PTSN. 

(d) The system displays recovered purse add value transactions. These are generated 7 days after receipt of a purse use 
for a purse that has a missing add value. These transactions don't display a Device ID, Date/time or Amount. These 
transactions display with the Item description "Purchase pending” along with the product name (Purse). 

2. For pass transactions: 

(a) The system displays recovered pass add value transactions. These are generated 7 days after receipt of a pass use for 
a pass that is not recorded at the back end. There is no indication for gap pass use transactions. These transactions 
don't display a Device ID, Date/time or Amount. These transactions display with the Item description “Purchase 
pending” along with the product name. 
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The system includes expired transactions in the transaction history list. By definition these are transactions that have 
arrived after the Transaction Expiration Period (currently defined as 7 days). There is no indication that the transactions are 
expired. Only the transaction types that are currently displayed have their expired transaction included, no new transaction 
types are being added. 

The system displays new card issue transactions. These transactions are sourced from card unblock UD where the previous 
blocking reason was "Blocked - Not Issued”. These transactions display with the description "Card Issue". These 
transactions are generated against the card account. Thus, the websites do not display any value under the product related 
columns (i.e. "product name”, “e-Purse Balance”, etc). Additionally, these transactions do not hold any financial value. 
Therefore, the websites do not show any value under the Txn Value/Amount column or Payment Method column. As for the 
Transaction type classification/filter (Sales vs. Usage), which is available on the transaction history page, these transactions 
are displayed under the ‘Sales’ filter. 

The system displays new card issue or replacement fee transactions. These transactions are sourced from the card issue or 
replacement fee UD. No fee transactions are displayed for Business Account cards or bulk card orders. These transactions 
are generated against the card account. Thus, the websites do not display any value under the product related columns (i.e. 
"product name”, “e-Purse Balance”, etc). 

The system displays replacement card issue transactions. These transactions are sourced from card replacement UD. 
Business Account card replacements using existing stock are not displayed. 


Table 32: Transaction History Source Data 
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UPDATED BY 


EXCEPTIONS/COMMENTS 


Location name = Internal DB look up based on 
the Device ID in UD 


Where the transaction occurred at 
a Retailer, the Transaction History 
will display a Retailer’s details as 
recorded for that Location (Metrix 
“Place Name"). The “Agency Short 
Name (Metrix "Place ID”) will not 
be displayed. 

Where the transaction occurred at 
the Cardholder Website, the 
Agency Short Name is not 
displayed and the format is 
"Cardholder Website.” 

Where the transaction occurred at 
the Call Center Website, the 
Agency Short Name (Metrix “Place 
ID”) will be displayed. The 
Location Name is replaced with 


Product name = Internal DB look up 
(SYSCD_PRODUCT) based on the prodi 
type in UD 

Validity month = UD for the transaction 
Year = UD for the transaction 


Product Name (max 83 chars) + 
Validity Month (max 9 chars) + 

(yyyy) 


Product name = ERG 


UD for the transaction 


Currency (symbolto 


UD for the transaction 


Currency (symbolto 


UD for purse related transactions 


Currency (symbolto indicate 0 value) 
MM/DD/YYYY 


Only displayed for remote website 


Autoload, Cash, Check, VISA/MCARD + last 
4 digits, Debit Card, Money Order, Purchase 
Order, Purse, Voucher 


Only displayed for product 
purchases and fee transactions. 
For credit card payments, the ce 


SEA-01654 

Revision 27.0/Apr 29, 2013 


Page 145 of 160 


















Central Puget Sound 

Regional Fare Coordination System 


Security Level 3 


ORCA Institutional Program Website 
_ Functional Specification 


Appendix C File Formats 

This section details the file formats for imports and exports on the Business Accounts website. There are three file formats used on the website 
and specified in this section: 

• Product Orders (import and export) - for CSV file format 

• Product Orders (import and export) - for XML file format 

• XML Card Personalization File (import only) - this is a XML file format 

Card printing templates are third party software in ZIP format. Their format is specified by the ID_Works application. 

C.1 Product Order Import/Export File Formats 
C.1.1 CSV File and Record Structure 


The table below outlines the CSV file elements for a Product Order: 

Table 33: Product Order CSV File Elements 


Seq No 

Column Header 

Description 

1 

name 

The Institution Name 

2 

id 

The Institution ID 

3 

agreementid 

The Agreement ID 

4 

businesschoicelist 

A list of all the business choice products currently available for this agreement. This list is included on export 
to provide the user with product information that may be required when importing an order. 

5 

voucherslist 

A list of all the voucher programs and products for this agreement. 

6 

businesspassportlist 

A list of all the business passport products for this agreement. 

7 

cardslist 

A list of all the cards and products in the current order. 


Vix Confidential © Vix 2013 

To be disclosed only to Agency personnel who have a need to know 


SEA-01654 

Revision 27.0/Apr 29, 2013 


Page 146 of 160 




Central Puget Sound 

Regional Fare Coordination System 


Security Level 3 


ORCA Institutional Program Website 
Functional Specification 


The table below details the format and rules for the CSV file elements: 


Table 34: Format and Rule for the CSV File Elements 


Seq 

No 

Column Header 

Column 

Header 

Description 

Mandatory 

/Optional 

Delimiter 

Simple 

/Complex 

Complex 

Elements/ 

per 

Record 

Complex 

Element 

Delimiter 

Complex 

Record 

Delimiter 

Description and 
Complex Record 
Examples 
(Two Records) 

1 

name 

Institution 

Name 

Mandatory 


Simple 




Institution Name 

2 

id 

Institution Id 

Mandatory 


Simple 




Institution Id 

3 

agreementid 

Agency 
Agreement Id 

Mandatory 


Simple 




Agreement Id 

4 

businesschoice 

list 

The list of 
customized 
products 

Mandatory 


Complex 

3 


T 

PugetPass 
$1.00 ;18113;11 

Metro Pass; 18111 ;1| 

5 

voucherslist 

The list of 

voucher 

products 

Mandatory 


Complex 

3 


T 

Purse; 1065307 ;2| 

Pass ; 1064801 ;2| 


businesspassp 

ortlist 

The list of 
right to ride 
products 

Mandatory 


Complex 

3 


f 

Pierce R2R 

Pass ; 18875 ;1| 

Sound R2R 

Pass ; 18876 ;11 

7 

cardslist 


Mandatory 


Complex 

7 


T 

99914288; 18865 ;1;09 
/2008; 12/2009 ;0;Reg 
R2R Pass| 

99914288; 18876 ;1;09 
/2008 ; 12/2009 ; 0 ; Sou 


Sequence Number; used to indicate the expected position in the sequence of Columns/Elements of data in the CSV File. The Sequence number 
is not part of the file used by the import or produced by the export. The sequence number indicates the required positioning of data that will be 
read and uploaded into the system or the position of the data written by the system during export. 


Column Header; The first line/record of the CSV contains the name of the column used for import or export. NOTE: If the data in any element (for 
example institution name or voucher program name) contains a comma then this element needs to be contained within quotes (for example 
“Institution, name"). 
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Column Header Description: Used here to explain what the column represents and will be used for. Not part of the file used for import and 
export. 

Mandatorv/Ootional: Used here to explain if the data is either mandatory data or optional. Mandatory data is data that is required. If the data is 
empty or incorrect the import may fail or produce unexpected results. Optional data can be represented by an empty column. Not part of the file 
used for import and export. 

Delimiter: Used to mark the end of the record element/column. 

Simple/Complex: Indicates if the column contains either simple or complex elements. Simple elements will not be broken down into smaller 
constituencies. Complex Elements can contain any number of complex element records. The end of the record is delimited by a T character. 
Complex record elements can contain any number of elements with each record delimited by a character. 

Complex Elements per Record: Indicates the number of elements per complex element record required to be separated by a complex element 
delimiter. 

Complex Element Delimiter: Used to mark the end of the record element/column. 

Note: Elements/Columns containing one or more complex elements/columns will be delimited further. The record elements/column containing 
such complex elements/columns will need the delimiter that will mark the end of the records element/column. 

E.g. A record with two records with delimiters marked in red, 

{reel-simple-item} , {complex-items} , {complex-items} , 

{rec2-simple-item} , {complex-items} , {complex-items} , 

Complex Record Delimiter: The delimiting character used to mark the end of a complex element record. 

The example below shows a record with two complex elements with each having two complex records. 

recl-simple-item; x;y;z | a;b;c |, torn;o | s;t;u |, 

Red Comma = Column/record delimiter 
Black Semicolon = Complex Element Delimiter 
Red vertical line,= Complex Record Delimiter 


Complex Elements are described in Table 35 below: 


Table 35: Complex Elements Description 


Complex Elements 

Record Elements 

Description 

Businesschoicelist 

1 

Product Name 


2 

Product Id 


3 

Product Type (1=Product, 2=Voucher) 
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Complex Elements 

Record Elements 

Description 




Voucherslist 

1 

Voucher Name 


2 

Voucher Id 


3 

Voucher Type (1=Product, 2=Voucher) 




Businesspassportlist 

1 

Product Name 


2 

Product Id 


3 

Product Type (1=Product, 2=Voucher) 




Cardslist 

1 

Card Serial Number 


2 

Program Product Id 


3 

Program Product Type (1=Product, 2=Voucher) 


4 

Start month/year 


5 

End month/year 


6 

Purse revalue amount (in cents) 


7 

Sales Product Name 


An example CSV record with delimiters is shown in Figure 86 


agreements, 

1050820 1050781, 


customizedlist, 


rse ; 1065 307 , -2 | 
ss;1064801;2| , 


09/2008,-12/2009; 


Figure 86: Example Product Order - CSV Format 
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C.1 .2 XML Product Order File and Record Structure 

The specification for the Product Order file is shown below. 


Note: Items in bold text are example data only, used to illustrate the elements further. 


File Element 

Description/layout 

<?xml version="1.0" encoding="UTF-8" ?> 

Standard XML file header 

<productorder> 

Start file description node 

<institution> 

Start institution node 

<name>ACME Products lnc</name> 

Institution name node 

<id>1050820</id> 

Institution id node 

</institution> 

End institution node 

<agreement> 

Start agreement node 

<id>1 050781 </id> 

Agreement id node 

</agreement> 

End agreement node 

<programs> 

Start program node 

ebusiness choice> 

Start business choice node 

eproduct id= "18113 1>PugetPass $1 .00</product> 

Business choice product node 

eproduct id="18107 1>Everett Transit Monthly Reduced Fare Pass</product> 

Business choice product node 

</business choice> 

End business choice node 

<vouchers> 

Start voucher node 

cvoucher name='Voucher program 1 "> 

Start voucher program node 

eproduct id= "1065310 2 ">Purse</product> 

Voucher product node 

</voucher> 

End voucher program node 

cvoucher name='Voucher program 2"> 

Start voucher program node 

eproduct id="1064417 2 >AII-Day PugetPass $4.00</product> 

Voucher product node 

eproduct id="1064418 2 >Everett Transit Monthly Reduced Fare Pass</product> 

Voucher product node 

eproduct id="1 064419 2 >Everett Transit Monthly Shuttle Pass</product> 

Voucher product node 

eproduct id= "1064420 2 >KCM 10 Ride $0.25</product> 

Voucher product node 

eproduct id= '1064421 2 >KCM 10 Ride $0.50</product> 

Voucher product node 

eproduct id= '1064454 2 >PugetPass $1 .25</product> 

Voucher product node 

eproduct id='1064490 2’>Purse</product> 

Voucher product node 

</voucher> 

End voucher program node 

</vouchers> 

End voucher node 

ebusiness passport> 

Start business passport node 
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File Element 

Description/layout 

<product id="18422_1 >Regional R2R Pass</product> 

Business passport product 
node 

<product id="18859_1 >Regional Bus And Train R2R Pass</product> 

Business passport product 
node 

<product id="18876_1 >Sound Transit R2R Pass</product> 

Business passport product 
node 

</business passport> 

End business passport node 

</programs> 

End program node 

<cards> 

Start cards node 

<card csn="99914286”> 

Start card node 

Card serial number 

<product id="18865_1 " validityStartDate = "1 2/2009" validityEndDate = 09/2008" 
revalueAmount- '0”>Regional R2R Pass</product> 

Start product node 

Product id (Program 
Product ID + + 

Program Product 

Type) 

Product start date 
Product end date 
Revalue amount 
Product name 

End product node 

<product id="18876_1 " validityStartDate ="12/2009" validityEndDate ="09/2008" 
revalueAmount- '0”>Sound Transit R2R Pass</product> 

Start product node 

Product id (Program 
Product ID + + 

Program Product 

Type) 

Product start date 
Product end date 
Revalue amount 
Product name 

End product node 

</card> 

End card node 

<card csn="99914288"> 

Start card node 

Card serial number 

<product id="1 8859_1 " validityStartDate ="12/2009" validityEndDate ="09/2008" 

revalueAmount ”0”>Regional Bus And Train R2R Pass</product> 

Start product node 

Product id (Program 
Product ID + ‘J + 
Program Product 
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File Element 

Description/layout 


Type) 

Product start date 
Product end date 
Revalue amount 
Product name 

End product node 

<product id="18865_1 " validityStartDate = "12/2009” validityEndDate = 09/2008 
revalue Amount "tr Regional R2R Pass</product> 

Start product node 

Product id (Program 
Product ID + ‘J + 
Program Product 

Type) 

Product start date 
Product end date 
Revalue amount 
Product name 

End product node 

</card> 

End card node 

</cards> 

End cards node 

</productorder> 

End file description node 
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C.2 Card Personalization File Format - XML File and Record Structure 

The information below provides the XML file layout for the Card Personalization file. 

Note: Items in bold text are example data only, used to illustrate the elements further. 


File Element 

Description/Layout 

<?xml version='"l .0" encoding="UTF-8" ?> 

Standard XML file header 

<cardList> 

Start file description node 

<card> 

Start card node 

<templateField> 

Start template field node (As many data fields per card as 
specified in the ID Works template) 

<fieldName>FirstName</ fieldName > 

Field name node (This field name must match the 
corresponding ID Works field name) 

<fieldData>John</ fieldData > 

Field data node 

</ templateField > 

End template field node 

<templateField> 

Start template field node 

<fieldName>LastName</ fieldName > 

Field name node 

<fieldData>Smith</ fieldData > 

Field data node 

</ templateField > 

End template field node 

<templatelmage> 

Start template image node (Only 1 image per card) 

<fieldName>Profilelmage</ fieldName > 

Field name node (This field name must match the 
corresponding ID Works field name) 

<imageData>84592gv8Z53815Zb82bA68g</ imageData > 

Image date node (This is Base64 data. There are free 
converters available online to convert images to Base64 
data.) 

</ templatelmage > 

End template image node 

</card> 

End card node 

<card> 

Start card node 

<templateField> 

Start template field node 

<fieldName>FirstName</ fieldName > 

Field name node 

<fieldData>Sarah</ fieldData > 

Field data node 

</ templateField > 

End template field node 

<templateField> 

Start template field node 

<fieldName>LastName</ fieldName > 

Field name node 

<fieldData>Connor</ fieldData > 

Field data node 

</ templateField > 

End template field node 

<templatelmage> 

Start template image node 
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File Element 

Description/Layout 

<fieldName>Profilelmage</ fieldName > 

Field name node 

<imageData>84592gv8Z53815Zb82bA68g</ imageData > 

Image date node 

</ templatelmage > 

End template image node 

</card> 

End card node 

</ cardList > 

End file description node 
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C.3 Create/Maintain Card Groups - XML File and Record Structure 


File Element 

Description/layout 

<?xml version="1.0" encoding="UTF8" ?> 

Standard XML file header 

<maintaincardqroups> 

Start file description node 

<institution> 

Start institution node 

<name>IMix BA 001</name> 

Institution name node 

<id> 1050479 </id> 

Institution id node 

</institution> 

End institution node 

<cardgroups> 

Start card groups node 

<cardqroup> 

Start card group node 

<id>382</id> 

Card group id node 

<name> 1234567890123456789012345678901234567890 </na me > 

Card group name node 

</cardgroup> 

End card group node 

<cardgroup> 

Start card group node 

< id > 1050405 </id> 

Card group id node 

<name>Default Group 1050479</name> 

Card group name node 

</cardgroup> 

End card group node 

<cardqroup> 

Start card group node 

<id>451</id> 

Card group id node 

<name>Group for New Branch</name> 

Card group name node 

</cardgroup> 

End card group node 

<cardqroup> 

Start card group node 

<id>405</id> 

Card group id node 

<name>test</name> 

Card group name node 

</cardgroup> 

End card group node 

<cardgroup> 

Start card group node 

<id>452</id> 

Card group id node 

<name>test 2</name> 

Card group name node 

</cardgroup> 

End card group node 

</cardgroups> 

End card groups node 

<cards> 

Start cards node 

<card> 

Start card node 

<cardserialnumber>99918010</cardserialnumber> 

Card serial number node 
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<groupid>405</groupid> 

Card group id node 

</card> 

End card node 

<card> 

Start card node 

<cardserialnumber>99918011</cardserialnumber> 

Card serial number node 

<groupid>405</groupid> 

Card group id node 

</card> 

End card node 

<card> 

Start card node 

<cardserialnumber>99916969</cardserialnumber> 

Card serial number node 

<groupid>405</groupid> 

Card group id node 

</card> 

End card node 

<card> 

Start card node 

<cardserialnumber>99918000</cardserialnumber> 

Card serial number node 

<groupid > 1050405 </groupid> 

Card group id node 

</card> 

End card node 

</cards> 

End cards node 

</maintaincardgroups> 

End file description node 
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Appendix D Traceability Matrix 

Table 36 shows the traceability between the non-Contract changes (CCA#3 
RFIs/Requirements, Change Orders (COs), and Change Requests (CRs)) and this 
document. 
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